diff --git a/converter/newfiles/doc_rest.rst b/converter/newfiles/doc_rest.rst index 064d576df5..11d111f529 100644 --- a/converter/newfiles/doc_rest.rst +++ b/converter/newfiles/doc_rest.rst @@ -4,22 +4,25 @@ reStructuredText Primer ======================= 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 `_. + The authoritative `reStructuredText User + Documentation `_. 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 @@ -226,4 +229,4 @@ All Python documentation source files must be in UTF-8 encoding, and the HTML documents written from them will be in that encoding as well. -XXX: Gotchas \ No newline at end of file +XXX: Gotchas