Exercises (documentation lesson)
Before you start
Discuss the exercise idea with the classroom.
Distribute exercises among groups of 2-3 persons.
Open a GitHub issue and inform the community about the problem and how you plan to solve it. Discuss why we do this.
Fork this project.
Commit to your fork. In your commit message auto-close the issue you have addressed.
Submit a pull request.
We then review the pull requests.
After the pull requests are merged we verify that documentation updates itself.
Basic
Document the purpose of this example code.
Document how to clone the code.
Describe the project tree structure.
Write a sentence or two about Zipf’s law and link to Wikipedia (coordinate with the group working on the previous exercise).
Document how to check the code style with
pycodestyle
.Give other developers hints on how they can contribute to the documentation.
Document how to build the documentation locally (coordinate with the group working on the previous exercise).
Add an example output.
Add an example plot (coordinate with the group working on the previous exercise).
Document where/how to ask for help.
Add a math equation somewhere.
Advanced
Add a test and document how to run it.
Add the possibility to auto-document Python code.
Meta
Add new exercises ideas for future workshops (edit this file).