Which doc format to use? Inline Doxygen/rst/markdown

Clang Frontend
4

I switched the llvm release notes to Markdown - RFC: Convert LLVM's Release Notes to Markdown. My justifications were specific to that file and the kind and frequency of contributions it gets. So as you say, not a global policy change.

For maintainer files, we had a mix of formats so anything converted from plain text, or a new file, I used Markdown. Mostly because of my own bias. The features of RST used for the average maintainer file all render well on Github itself, where people often read those files.

At the moment:

$ find -name "Maintainers.*" | grep "Maintainers.*" -o | sort | uniq -c
     16 Maintainers.md
      4 Maintainers.rst
1 Like