Actions
Task #3238
closedUpdate Salt documentation
Start date:
Due date:
% Done:
100%
Tags:
Documentation, Salt
URL:
Description
'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 Brett Cornwall almost 4 years ago
Brett Cornwall wrote:
- Review if Python's .rst format/Makefile/sphinx is the desired format to use or if markdown would be preferred these days
guilhem, what are your thoughts on format?
Updated by Guilhem Moulin almost 4 years 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.
Updated by Brett Cornwall almost 4 years ago
- Assignee set to Brett Cornwall
- Tags Documentation added
Updated by Brett Cornwall almost 4 years ago
- Status changed from New to In Progress
Updated by Brett Cornwall almost 2 years ago
- Status changed from In Progress to Resolved
- % Done changed from 0 to 100
Updated by Brett Cornwall almost 2 years ago
- Status changed from Resolved to Closed
Actions