In unit 4, you will learn how to semi-automatically generate a documentation for your code, and what you need for a good documentation. Documenting your software is crucial if you want to attract users and collaborators.
If you run into problems at any point, please contact us via [email protected] or open an issue on github.
The slides for this session are found here. The demonstrations are listed here and the necessary commands for the live lession are summarized here.
we will learn about the importance and ingredients of a good documentation.
Please create a user account on readthedocs.
Please complete the learning lab on how to set up GitHub pages.
Set up sphinx for your package. You will commit the changes under the account of one team member, however it is encouraged that all of you try to set up sphinx locally on your computer. Continue to develop your documentation into something that is worth showing others. Look at the other team's documentations and identify aspects that raise your interest for their software.