Anonymous avatar Anonymous committed e222f96

[Carl Cerecke] Reword first section.

Comments (0)

Files changed (1)

converter/newfiles/doc_rest.rst

 =======================
 
 This section is a brief introduction to reStructuredText (reST) concepts and
-syntax, to provide authors enough information to autor documents productively.
+syntax, intended to provide authors with enough information to author
+documents productively.
 Since reST was designed to be a simple, unobtrusive markup language, this will
 not take too long.
 
 .. seealso::
 
-   The authoritative `reStructuredText User
-   Documentation <http://docutils.sourceforge.net/rst.html>`_.
+    The authoritative `reStructuredText User
+    Documentation <http://docutils.sourceforge.net/rst.html>`_.
 
 
 Paragraphs
 ----------
 
-The most basic block a reST document is made of.  Paragraphs are chunks of text
-separated by one ore more blank lines.  As in Python, indentation is significant
-in reST, so all lines of a paragraph must be left-aligned.
+The paragraph is the most basic block in a reST document.
+Paragraphs are simply chunks of text
+separated by one or more blank lines.  As in Python, indentation is significant
+in reST, so all lines of the same paragraph must be left-aligned
+to the same level of indentation.
 
 
 Inline markup
 documents written from them will be in that encoding as well.
 
 
-XXX: Gotchas
+XXX: Gotchas
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.