Page MenuHomePhabricator

Include reply action ("!action") hints in outbound email
Open, Needs TriagePublic

Description

I always forget about the commands that can be used to interact with tasks/diffs via email (!claim for example). I think that these use to exist and were moved to a help document somewhere.

Event Timeline

joshuaspence raised the priority of this task from to Needs Triage.
joshuaspence updated the task description. (Show Details)
joshuaspence added a project: Mail.
joshuaspence added a subscriber: joshuaspence.
eadler added a subscriber: eadler.May 30 2015, 1:02 AM
chad added a subscriber: chad.May 30 2015, 1:14 AM

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.

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.

eadler added a project: Restricted Project.Jan 9 2016, 12:35 AM
eadler moved this task from Restricted Project Column to Restricted Project Column on the Restricted Project board.
eadler moved this task from Restricted Project Column to Restricted Project Column on the Restricted Project board.Feb 18 2016, 6:32 PM
eadler moved this task from Restricted Project Column to Restricted Project Column on the Restricted Project board.Jul 4 2016, 9:06 PM
epriestley renamed this task from Include hints in outbound email to Include reply action ("!action") hints in outbound email.Jul 16 2016, 2:02 PM
eadler moved this task from Backlog to Nits on the llvm board.

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/

epriestley moved this task from Backlog to Future on the Mail board.Feb 8 2018, 5:58 PM

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.