-
Notifications
You must be signed in to change notification settings - Fork 126
Description
Right now the documentation is a bit 'remote' from the code - keeping the documentation in the main repo (for things like ld-decode.py and the tool-chain) would allow PR reviewers to ensure documentation and code are updated at the same time.
I'm thinking perhaps there can be a "standard" - each tool/etc must provide a docs/ directory that contains userguide.md and any associated pngs etc. Readme.md could also be part of this too - but we'd need to think about the way to gets used in the wiki.
Then we set up some github actions to:
- Clone the .wiki.git repo
- Copy the file over
- Commit and push automatically
Clearly the wiki structure would have to be modified a bit to do this, but it could help to a) lower the work of wiki maintenance and b) keep everything up to date.
Downside is, tool documentation has to be done via PRs, but that's a small price imho.