Update Salt documentation
'There are lots of README.rst files throughout the repo.
- Determine the policy of module documentation: Revisit doc/guideline.rst to see if any policies need revising.
- Review if Python's .rst format/Makefile/sphinx is the desired format to use or if markdown would be preferred these days
- Comb through each module and update
Many of the README.rst files are just stating the obvious (e.g. "The apt module configures apt-related settings") and can be removed.
Updated by Guilhem Moulin over 1 year ago
guilhem, what are your thoughts on format?
No hard feeling but my preference would to use markdown, especially since both gerrit and GitLab can render it natively (no need for an external processor). Would prefer a grep-able source format in any case, be it .rst, .md, or something else.