Browse Source

Manual: Improvements to summary by Thomas Dye

Carsten Dominik 4 years ago
parent
commit
e0dd999a7b
1 changed files with 9 additions and 9 deletions
  1. 9 9
      doc/org.texi

+ 9 - 9
doc/org.texi

@@ -798,10 +798,9 @@ MobileOrg
 @section Summary
 @cindex summary
 
-Org is a mode for keeping notes, maintaining TODO lists, and doing project
-planning with a fast and effective plain-text system.  It also is an
-authoring system with unique support for literal programming and reproducible
-research.
+Org is a mode for keeping notes, maintaining TODO lists, and project planning
+with a fast and effective plain-text system.  It also is an authoring system
+with unique support for literate programming and reproducible research.
 
 Org is implemented on top of Outline mode, which makes it possible to keep
 the content of large files well structured.  Visibility cycling and structure
@@ -819,12 +818,13 @@ Allen's GTD system.
 
 Org files can serve as a single source authoring system with export to many
 different formats such as HTML, @LaTeX{}, Open Document, and Markdown.  New
-export backends be derived from existing ones, or defined from scratch.
+export backends can be derived from existing ones, or defined from scratch.
 
-Org mode supports working with embedded source code blocks in a file, which
-makes it uniquely suited for authoring technical documents with code
-examples.  It facilitates code evaluation, capturing code output into the
-document, documentation, and literate programming techniques.
+Org files can include source code blocks, which makes Org uniquely suited for
+authoring technical documents with code examples. Org source code blocks are
+fully functional; they can be evaluated in place and their results can be
+captured in the file.  This makes it possible to create a single file
+reproducible research compendium.
 
 Org keeps simple things simple.  When first fired up, it should feel like a
 straightforward, easy to use outliner.  Complexity is not imposed, but a