-
Notifications
You must be signed in to change notification settings - Fork 8
Best Practices for writing editing updating documentation
Ankita Tripathi edited this page Jun 23, 2021
·
1 revision
- Include A README file that contains
- A brief description of the project
- Installation instructions
- A short example/tutorial
- Allow issue tracker for others
- Write an API documentation
- What does a function do
- What are the function's parameters or arguments
- What does a function return
- An example for code documentation.
- Document your code
- Apply coding conventions, such as file organization, comments, naming conventions, programming practices, etc.
- Include information for contributors
- Include citation information
- Include licensing information
- List all the version of the files along with the major edits you did in each version