[elpa] externals/denote f3d1706f95 1/5: Reword docs for changing front matter format

[ELPA Syncer]

branch: externals/denote
commit f3d1706f9527c78cb51eeeebf04aac13792cc369
Author: Protesilaos Stavrou <info@protesilaos.com>
Commit: Protesilaos Stavrou <info@protesilaos.com>

    Reword docs for changing front matter format
---
 README.org | 20 +++++++-------------
 1 file changed, 7 insertions(+), 13 deletions(-)

diff --git a/README.org b/README.org
index 05acb48e1e..b4952766ef 100644
--- a/README.org
+++ b/README.org
@@ -1002,19 +1002,14 @@ The variables which hold the front matter format are:
 #+vindex: denote-yaml-front-matter
 - ~denote-yaml-front-matter~
 
-These variables hold a string with specifiers that are used by the
-~format~ function.  The formatting operation passes four arguments (five
-in the case of ~denote-text-front-matter~ as noted in its doc string)
-which include the values of the given entries.  The doc string of
-~denote-org-front-matter~ describes the technicalities:
+These variables have a string value with specifiers that are used by the
+~format~ function.  The formatting operation passes four arguments which
+include the values of the given entries.  If you are an advanced user
+who wants to edit this variable to affect how front matter is produced,
+consider using something like =%2$s= to control where the Nth argument
+is placed.
 
-#+begin_quote
-The order of the arguments is TITLE, DATE, KEYWORDS, ID.  If you are an
-advanced user who wants to edit this variable to affect how front matter
-is produced, consider using something like %2$s to control where Nth
-argument is placed.
-
-Make sure to:
+When editing the value, make sure to:
 
 1. Not use empty lines inside the front matter block.
 
@@ -1023,7 +1018,6 @@ Make sure to:
 
 These help with consistency and might prove useful if we ever need to
 operate on the front matter as a whole.
-#+end_quote
 
 With those granted, below are some examples.  The approach is the same
 for all variables.