[elpa] externals/denote 3e2b560548 099/355: Elaborate on the Overview of Denote

[ELPA Syncer]

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

    Elaborate on the Overview of Denote
---
 README.org | 38 +++++++++++++++++++++++++++++++++-----
 denote.el  | 35 ++++++++++++++++++++++++++++++-----
 2 files changed, 63 insertions(+), 10 deletions(-)

diff --git a/README.org b/README.org
index c18ebb56d7..7ee2f45241 100644
--- a/README.org
+++ b/README.org
@@ -70,11 +70,39 @@ modify this GNU manual.”
 :CUSTOM_ID: h:a09b70a2-ae0b-4855-ac14-1dddfc8e3241
 :END:
 
-Denote is a simple note-taking tool.  It is based on the idea that notes
-should follow a predictable and descriptive file-naming scheme.  The
-file name must offer a clear indication of what the note is about,
-without reference to any other metadata.  Denote basically streamlines
-the creation of such files.
+Denote is a simple, yet effective note-taking tool for Emacs.  It is
+based on the principle that notes must follow a predictable and
+descriptive file-naming scheme.  The file name alone should offer a
+clear indication of what the note is about, without reference to any
+other metadata.  Denote basically streamlines the creation of such
+files.
+
+What Denote prioritizes with the enforcement of a strict file-naming
+scheme is portability.  Notes can be accessed, filtered, and understood
+without Emacs or any other advanced tool for that matter (though Emacs,
+Org, and others are excellent programs).
+
+Denote has no mechanism to test for adherence to a given note-taking
+method, such as that of Zettelkasten (i.e. the contemporary digital
+equivalent of Niklas Luhmann's methodology).  It is possible to employ
+such a method, though it is ultimately up to the user to apply the
+requisite rigor.  What matters for our purposes is that Denote is not a
+zettelkasten implementation per se.
+
+By default, Denote creates note files using the =.org= extension.
+However, Denote does not depend on org.el or any of its accoutrements
+and extensions.  Users are given the option to change from Org to either
+Markdown (=.md=) or Plain Text (=.txt=), as explained further in the
+manual (search for ~denote-file-type~).
+
+"Denote" is the familiar word, though it also is a play on to the "note"
+concept.  Plus, we can come up with acronyms (of dubious utility) like:
+
++ Don't Ever Note Only The Ephemeral
++ Denote Everything Neatly; Omit The Excesses
+
+But we'll let you get back to work.  Don't Escape or Neglect your
+Obligations, Tasks, Engagements...
 
 * The file-naming scheme
 :PROPERTIES:
diff --git a/denote.el b/denote.el
index 454398fb64..57d324c512 100644
--- a/denote.el
+++ b/denote.el
@@ -24,13 +24,38 @@
 
 ;;; Commentary:
 ;;
-;; "Denote" is the familiar word, though it also is a play on to the
-;; "note" concept.  Plus, we can come up with acronyms like:
+;; Denote is a simple, yet effective note-taking tool for Emacs.  It is
+;; based on the principle that notes must follow a predictable and
+;; descriptive file-naming scheme.  The file name alone should offer a
+;; clear indication of what the note is about, without reference to any
+;; other metadata.  Denote basically streamlines the creation of such
+;; files.
 ;;
-;; * Don't Ever Note Only The Ephemeral
-;; * Denote Everything Neatly; Omit The Excesses
+;; What Denote prioritizes with the enforcement of a strict file-naming
+;; scheme is portability.  Notes can be accessed, filtered, and understood
+;; without Emacs or any other advanced tool for that matter (though Emacs,
+;; Org, and others are excellent programs).
 ;;
-;; But I'll let you get back to work.  Don't Escape or Neglect your
+;; Denote has no mechanism to test for adherence to a given note-taking
+;; method, such as that of Zettelkasten (i.e. the contemporary digital
+;; equivalent of Niklas Luhmann's methodology).  It is possible to employ
+;; such a method, though it is ultimately up to the user to apply the
+;; requisite rigor.  What matters for our purposes is that Denote is not a
+;; zettelkasten implementation per se.
+;;
+;; By default, Denote creates note files using the `.org' extension.
+;; However, Denote does not depend on org.el or any of its accoutrements
+;; and extensions.  Users are given the option to change from Org to either
+;; Markdown (`.md') or Plain Text (`.txt'), as explained further in the
+;; manual (search for `denote-file-type').
+;;
+;; "Denote" is the familiar word, though it also is a play on to the "note"
+;; concept.  Plus, we can come up with acronyms (of dubious utility) like:
+;;
+;; + Don't Ever Note Only The Ephemeral
+;; + Denote Everything Neatly; Omit The Excesses
+;;
+;; But we'll let you get back to work.  Don't Escape or Neglect your
 ;; Obligations, Tasks, Engagements...
 
 ;;; Code: