Very nice, thanks!
:-)
Some issues.
* s/comfig/config/.
Oops, fixed!
* I'm not happy with
To continue a list over multiple paragraphs, start the paragraphs
with a tilde (~) character.
I would rather prefer that a continuation is indented as before.
Example:
1. Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
viverra nec, fringilla in, laoreet vitae, risus.
Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.
[IIRC, Pandoc supports this style.] Is this possible? What do you
think?
The problem with this is, DocPara objects strip leading and trailing
spaces in the string before storing the words in an array. Doing this will
involve analysis of the lines before indentation data is removed, and
creating another object to store lists. This is not good, because we're
essentially doing work that the markdown parser is supposed to do.
This may actually require a complete restructuring of the docs making
all content WYSIWYG, and ensuring all indentation is exactly how we
want it to be in the markdown output.
Or do you think there's another way?
* Shall we mention that we prefer two spaces after a full stop ending
a sentence? Ditto for details on uppercasing in section titles (US
style, for example `This and That'), how to cite a C function
(without trailing parentheses), etc., etc.
You know a lot more about these small details, and I think these should
be added to make the file a nice guide to always refer to. I have added
you as a collaborator, please add the necessary information!