Documentation - msupply-foundation/open-msupply GitHub Wiki
Feature documentation should be done by the team that implemented the feature. Please also update the Introduction and Permissions pages if needed.
Any Pull Request (PR) that has changes to the functionality or User Interface (UI) needs to be labelled with docs: external
and the Documentation
part of the PR needs to be filled out. You do not have to write up the whole documentation here, just a couple of bullet points or screenshots to indicate what has been changed / how it should work.
Any updates to the public docs should be done in a PR branched off the current staging
branch in the mSupply_docs repository and will be merged on release cycle's PR merged date.
Example:
## 📃 Documentation
<!-- Note down any areas which require documentation updates -->
- [ ] New `issued` column in `Requisitions` indicates stock quantity already in shipments
- We use New Zealand English spelling conventions
- Only screenshot the
App Nav
section when screenshottinggotos
- Use a table when listing out columns with descriptions
- Try not to get the App Nav in screenshots or have it collapsed so that screenshots don't have to be updated when App Nav is updated
- You can add a callout-style section by adding a
div
with a class ofnote
,tip
,omsupdate
,warning
( for Spanish and French translators, yes, you can usenota / remarque
,conseil / consejo
,mise-a-jour / noticia
,aviso / avertissement
)
- You can also add an image title using a div with the
imagetitle
class
- When inserting images, we prefer the syntax
![Image description](/docs/catalogue/images/image_name.png)
. You may need to use the<img/>
tag when adding images to<div/>
elements, such as notes, don't use them elsewhere though. - Use simple language, and think carefully about how ambiguous the wording can be. Check your assumptions and tend toward being more descriptive than you might otherwise when explaining things.
- When writing bullet lists, these should be terminated with full stop if the line consists of multiple sentences, and not have a full stop if consisting of a single sentence
Any part of the code base that needs internal documentation needs to be labelled with docs: internal
.
Once you have done the docs whether they be external or internal, please change the label from docs: external
or docs: internal
to doc: done