|author||Jonas Smedegaard <firstname.lastname@example.org>||2015-01-13 03:09:02 +0100|
|committer||Jonas Smedegaard <email@example.com>||2015-01-13 03:09:02 +0100|
1 files changed, 9 insertions, 30 deletions
@@ -3,41 +3,20 @@
This is a guide for reliably editing text-heavy documents.
-This guide distinguishes between the following works:
+In this guide,
+*"master text"* means an edited document with only semantic markup,
+and *"final document"* means a document with presentational markup.
-: document with semantic markup.
+An *"author"* is the creator and owner of master texts,
-: document with presentational markup.
+A *"designer"* is the creator and owner of presentation for master texts.
+An *"editor"* selects and prepares master texts for further processing,
+and is responsible for coherence of content and of its presentation.
-This guide distinguishes between the following roles:
-: Write master texts.
-: Select and prepare master texts for further processing.
-: Compose visual presentation from master texts.
-Each role is distinct.
-Participants may have multiple roles, but only one at a time.
-Authors are responsible for master texts they write.
-Designers are responsible for visual presentations they compose.
-Editors are responsible for coherence of content and its presentation.
Authors and editors may refine markup in quotations
(e.g. replace "ASCII art" styling of lists with semantic equivalent),