Add docs for use of email with todo.sr.ht

1 files changed, 22 insertions, 0 deletions

diff --git a/todo.sr.ht/index.md b/todo.sr.ht/index.md
index 7d105be..95e3d8c 100644
--- a/todo.sr.ht/index.md
+++ b/todo.sr.ht/index.md
@@ -74,3 +74,25 @@ access settings for anonymous users, logged in users, and ticket submitters.
 
 You can delete your tracker here. Be careful as all tickets submitted to the
 tracker are deleted as well.
+
+# Email access
+
+You can submit new tickets by emailing them to
+`~username/tracker-name@todo.sr.ht`, or `u.username.tracker-name@todo.sr.ht` for
+poorly behaved MTAs.
+
+You can add comments to tickets by writing to
+`~username/tracker-name/ticket-id@todo.sr.ht`, or by replying to the
+notification email. The last line of your email can be one of the following
+commands:
+
+- `!resolve <resolution>`: closes the ticket with the given ticket resolution
+  (one of `fixed`, `implemented`, `wont_fix`, `by_design`, `invalid`,
+  `duplicate`, or `not_our_bug`)
+- `!reopen` to re-open a closed ticket
+
+All emails must be sent as `text/plain`. Please take care not to [top
+post](https://git-send-email.io/top-posting.html), as the full contents of your
+email will be posted as a comment.
+
+Markdown is supported.