[elpa] externals/denote 1e584e26dd 2/9: Update introduction to "Renaming files" section

[ELPA Syncer]

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

    Update introduction to "Renaming files" section
---
 README.org | 25 +++++++++++++++++++------
 1 file changed, 19 insertions(+), 6 deletions(-)

diff --git a/README.org b/README.org
index 5a372a36a0..686fe435f0 100644
--- a/README.org
+++ b/README.org
@@ -411,12 +411,25 @@ In concrete terms, this is a representation of the 
directory structures
 :CUSTOM_ID: h:532e8e2a-9b7d-41c0-8f4b-3c5cbb7d4dca
 :END:
 
-Denote's file-naming scheme is not specific to notes or text files: it
-is useful for all sorts of files, such as multimedia and PDFs that form
-part of the user's longer-term storage 
([[#h:4e9c7512-84dc-4dfb-9fa9-e15d51178e5d][The file-naming scheme]]).  While
-Denote does not manage such files (e.g. doesn't create links to them),
-it already has all the mechanisms to facilitate the task of renaming
-them.
+Denote provides commands to rename files and update their front matter
+where relevant.  For Denote to work, only the file name needs to be in
+order, by following our naming conventions 
([[#h:4e9c7512-84dc-4dfb-9fa9-e15d51178e5d][The file-naming scheme]]).
+The linking mechanism, in particular, needs just the identifier in the
+file name ([[#h:fc913d54-26c8-4c41-be86-999839e8ad31][Linking notes]]).
+
+We write front matter in notes for the user's convenience and for other
+tools to make use of that information (e.g. Org's export mechanism).
+The renaming mechanism takes care to keep this data in sync with the
+file name, when the user performs a change.
+
+Renaming is useful for managing existing files created with Denote, but
+also for converting older text files to Denote notes.
+
+Lastly, Denote's file-naming scheme is not specific to notes or text
+files: it is useful for all sorts of items, such as multimedia and PDFs
+that form part of the user's longer-term storage.  While Denote does not
+manage such files (e.g. doesn't create links to them), it already has
+all the mechanisms to facilitate the task of renaming them.
 
 ** Rename a single file
 :PROPERTIES: