SoftDev4Research / 4OSS-lesson

The overall aim of these 4OSS in the shape of training materials will contribute to make research software FAIR.
https://SoftDev4Research.github.io/4OSS-lesson
Other
23 stars 22 forks source link

REC1: Documentation #29

Open rgaiacs opened 6 years ago

rgaiacs commented 6 years ago

Replace

For end-user, a good documentation should clearly state what problems the software is designed to solve and who the target audience is. Installation instruction should be added clearly-stated list of dependencies. Ideally these should be handled with an automated package management solution. The documentation should also depict some examples of how to use the software (ideally to solve real-world analysis problems), explanation of the expected inputs and outputs.

with

For end-user, a good documentation should clearly state what problems the software is designed to solve and who the target audience is. Installation instruction should include a list of dependencies and, ideally, suggestion of how to install the dependencies. The documentation should also depict some examples of how to use the software with explanation of the expected inputs and outputs.

Replace

The software API should be documented to a suitable level. In the best documentation, all functions/methods are documented including example inputs and outputs.

with

If the software has an API, all functions/methods from the API should be documented including example inputs and outputs.