There are a lot of them, and it's a bit of clutter for every email. We should probably call out the documentation more in email settings though.

https://secure.phabricator.com/applications/mailcommands/PhabricatorDifferentialApplication/revision/

I like the help live saver thing in the top right. that's where I always find them.

The issue is that I always forget to learn how to use this functionality until I want to respond to an email and then its too late.

I removed this on purpose when making the most recent round of modularization updates. My thinking was:

• I want email to be relatively concise, at least by default. This section seemed like one of the least useful mail sections to include in every mail to me. However, until recent work it was the only way to discover the feature.
• The new help menu provides an alternate and more complete way to discover this feature. It's a less opportune way, but we can be much more complete in discussion of it.
• Now that commands are more flexible and modular, a complete description of available commands would be even larger than before (Differential and Maniphest now have 8+ commands, some of which take arguments, and this will probably increase over time, and third-party code can now add more commands). A concise description would probably require additional complexity in PHP (e.g., allow command to specify whether they are important enough to be called out in mail).

After HTML mail gets some more work (e.g., T6600) we'll have more flexibility and adding some kind of callout there potentially makes sense to me, but with text mail the minimum size of any callout is around 2-3 lines of space (header/label, text, link, surrounding whitespace). I think this generally too much space relative to the value of adding the reminder.

I think that these use to exist and were moved to a help document somewhere.

For the records, the document exists at https://secure.phabricator.com/applications/mailcommands/PhabricatorManiphestApplication/task/

T11934 plans to add these commands everywhere. If they're available all over the place, it might be less necessary to add reminders.

In HTML mail we could reasonably add a small reminder that links to the help page for the appropriate object type, although my general feeling is that these reminders aren't important enough to include in text mail.