Added an appendix about the documentation format.
Updated the "design decision" section.
Added functions to read stdin as a stream of lines.