From fb3e539eafe5f025b4966507643da08fbcbd8ec7 Mon Sep 17 00:00:00 2001
From: Fabien Dubosson <fabien.dubosson@gmail.com>
Date: Sat, 5 Dec 2015 16:03:34 +0100
Subject: [PATCH] Define a convention for message modes

---
 doc/CONVENTIONS.org | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/doc/CONVENTIONS.org b/doc/CONVENTIONS.org
index 7d42b781d..ca692c59b 100644
--- a/doc/CONVENTIONS.org
+++ b/doc/CONVENTIONS.org
@@ -15,6 +15,7 @@
      - [[n and N][n and N]]
      - [[Code Navigation][Code Navigation]]
      - [[=insert state= buffers][=insert state= buffers]]
+   - [[Messages editing][Messages editing]]
    - [[Evaluation][Evaluation]]
    - [[REPLs][REPLs]]
      - [[Send code][Send code]]
@@ -131,6 +132,20 @@ should be performed with ~C-j~ and ~C-k~ bindings for vertical movements.
 | ~C-j~ | go down     |
 | ~C-k~ | go up       |
 
+** Messages editing
+Modes that are used to edit messages (texts, notes, mails, …) and are subjects
+to user validation (traditionally bound to ~C-c C-c~ and ~C-c C-k~ in emacs)
+should use the following bindings:
+
+| Key       | Description               |
+|-----------+---------------------------|
+| ~SPC m ,~ | Valid/Confirm the message |
+| ~SPC m c~ | Valid/Confirm the message |
+| ~SPC m k~ | Abort/Discard the message |
+
+Some example of these modes are =magit= commit messages, =message-mode= for
+mails or =org-mode= notes.
+
 ** Evaluation
 Live evaluation of code is under the prefix ~SPC m e~.