Adding docs
As mentioned on the General Dev Workflow after changing something fundamental or adding a change in the docs or even a new docs page should be instantiated.
Docs per app
For the app side of our project (see what I did there? upside haha), you tend to use the README.md as the docs, that's why you should be very attentive with your README.MD, a general structure we recommend is the following:
Description
- what is the purpose of the project ?
Installation guide
- How to install it as a user? (generally we reccoment using
unios-repobut you should talk about install from source here) - How to install it as a developer (Yes we are technical people but give us a break too)
Project Structure
- Add a
treecommand output to explain the folders and the files of you project - Tell us about
sqldatabases and their schema if needed - Always add samples of files if the app is generating something.
Add your name and feel proud / roadmap
- We are almost done, now you can add your name here as a contributor and an emaila address you probably ignore
- Add a roadmap (maybe?) if you are quite sure about the next updates that you want help on, please add a roadmap
Document your changes
- It is usual for a person to refactor the project, please UPDATE the documentation so we can know what happened
Docs packages/repo/ISO
Because those three systems are indeed critical the docs don't really change because we don't change the way they work, any change in the docs of those systems will be made with the assistance of the maintainers.