nixpkgs/doc/contributing
Jan Tojnar 6ecc641d08
doc: prepare for commonmark
We are still using Pandoc’s Markdown parser, which differs from CommonMark spec slightly.

Notably:
- Line breaks in lists behave differently.
- Admonitions do not support the simpler syntax https://github.com/jgm/commonmark-hs/issues/75
- The auto_identifiers uses a different algorithm – I made the previous ones explicit.
- Languages (classes) of code blocks cannot contain whitespace so we have to use “pycon” alias instead of Python “console” as GitHub’s linguist

While at it, I also fixed the following issues:
- ShellSesssion was used
- Removed some pointless docbook tags.
2021-06-07 06:34:59 +02:00
..
coding-conventions.chapter.md doc: prepare for commonmark 2021-06-07 06:34:59 +02:00
contributing-to-documentation.chapter.md doc: prepare for commonmark 2021-06-07 06:34:59 +02:00
quick-start.chapter.md doc/contributing/*.xml: Convert to markdown 2021-04-23 12:53:58 +08:00
reviewing-contributions.chapter.md doc: prepare for commonmark 2021-06-07 06:34:59 +02:00
submitting-changes.chapter.md doc: prepare for commonmark 2021-06-07 06:34:59 +02:00
vulnerability-roundup.chapter.md documentation: Add content about Vulnerability roundups 2021-03-17 13:39:24 -07:00