>>>>> On Mon, 04 Jan 2021, Tim Harder wrote: > In terms of choice, I'd personally choose reStructuredText since that > generally plugs into python easier via docutils/sphinx (currently used > for pkgcore's man/html conversion), but am open to discussion of > alternatives such as markdown.
About reStructuredText vs Markdown: - ReST syntax is more complete and better standardised. - Markdown uses HTML as extension language, which is fine when converting to HTML but makes conversion to other formats more difficult. - Trailing whitespace as part of Markdown's syntax is problematic (and the current version of app-emacs/ebuild-mode removes it). - We already use ReST for some of our documentation, like GLEPs. Ulrich
signature.asc
Description: PGP signature
