include-files: Changed "prerequisites" to "note" and reworded section content. (#260)

* changed ##prerequisites to ##note and rewrote text

* reworded Note section

* wrapped text

Author: IlonaSilverwood

include-files/README.md

@@ -2,31 +2,30 @@
 
 Filter to include other files in the document.
 
-## Prerquisites
+## Note
 
-This filter needs to be executed before most other filters. Any
-filter that runs before this will only see the empty codeblocks.
+Do not run other filters before executing `include-files`, unless you are
+certain the other filter does not require `include-files` to function properly.
+Executing most filters without first using `include-files` will result in the
+other filter seeing an empty code block.
 
 ## Usage
 
-Use a special code block with class `include` to include files of
-the same format as the input. Each code line is treated as the
-filename of a file, parsed, and the result is added to the
-document.
+Use a special code block with class `include` to include files of the same
+format as the input. Each code line is treated as the filename of a file,
+parsed, and the result is added to the document.
 
 Metadata from included files is discarded.
 
 ### Shifting Headings
 
-The default is to include the subdocuments unchanged, but it can
-be convenient to modify the level of headers; a top-level header
-in an included file should be a second or third-level header in
-the final document.
+The default is to include the subdocuments unchanged, but it can be convenient
+to modify the level of headers; a top-level header in an included file should be
+a second or third-level header in the final document.
 
 #### Manual shifting
 
-Use the `shift-heading-level-by` attribute to control header
-shifting.
+Use the `shift-heading-level-by` attribute to control header shifting.
 
 #### Automatic shifting
 
@@ -54,32 +53,30 @@ file-a.md
 
 ### Comments
 
-Comment lines can be added in the include block by beginning a
-line with two `//` characters.
+Comment lines can be added in the include block by beginning a line with two
+`//` characters.
 
 ### Different formats
 
-Files are assumed to be written in Markdown, but sometimes one
-will want to include files written in a different format. An
-alternative format can be specified via the `format` attribute.
-Only plain-text formats are accepted.
+Files are assumed to be written in Markdown, but sometimes one will want to
+include files written in a different format. An alternative format can be
+specified via the `format` attribute. Only plain-text formats are accepted.
 
 ### Recursive transclusion
 
-Included files can in turn include other files. Note that all
-filenames must be relative to the directory from which they are
-included. I.e., if a file `a/b.md` is included in the main
-document, and another file `a/b/c.md` should be included from
-`a/b.md`, then the relative path from `a/b.md` must be used, in
-this case `b/c.md`. The full relative path will be automatically
-generated in the final document. The same goes for image paths and
-codeblock file paths using the `include-code-files` filter.
+Included files can in turn include other files. Note that all filenames must be
+relative to the directory from which they are included. I.e., if a file `a/b.md`
+is included in the main document, and another file `a/b/c.md` should be included
+from `a/b.md`, then the relative path from `a/b.md` must be used, in this case
+`b/c.md`. The full relative path will be automatically generated in the final
+document. The same goes for image paths and codeblock file paths using the
+`include-code-files` filter.
 
 ## Example
 
-Let's assume we are writing a longer document, like a thesis.
-Each chapter and appendix section resides in its own file, with
-some additional information in the main file `main.md`:
+Let's assume we are writing a longer document, like a thesis. Each chapter and
+appendix section resides in its own file, with some additional information in
+the main file `main.md`:
 
     ---
     author: me