/g/sicp readme for tuts
This is a document to docuwriters for instructions on writing them and
making requests for tutorial comments.
Just keep it simple and try to put yourself in the readers position when writing.
If general layout questions or such, just ask in the chan for help/ideas.
Document layout & syntax:
Use plain html to format the tuts/docs, easy to convert and easy to write.
Vote for LaTex:
For document title
For Major section title ie. 2
For Subsection title ie. 2.1
For highlighting in subsection or for sub sub section title ie. 2.2.1
for all text, remember to paragraph enough
for code blocks
- for lists, nested if needed
between every major and sub section
Using anchors and anchor names is encouraged in table of contents and section titles,
for easy navigation. Ie. in contents - nnnanan
and in body
See C++ tut for example.
You can use something like http://htmledit.squarefree.com/ to do live formatting,
RFCs
1. Fix everything you see/find to be typoed/wrong/blatantly wrong/or generally messed up