- Technical level
To learn how to write documentation for your codebases. Documentation is the key for communication and developers are the best person to start writing it. Projects can succeed or fail because of their documentation.
In the workshop the people will be introduced to reStructuredText & sphinx. Starting from quick-start of a project to document organization, code and topic cross-referencing, indexing. We will also go through running tests from your documentation, initial ideas on themes and deployment in readthedocs.
One can think about this workshop as the followup from last year's talk.
Quick summary of the workshop
- Introduction to reStructuredText
- Introduction to sphinx
- A project structure with docs
- hands-on tutorial with sphinx
- Integration with readthedocs
- An open mind to learn
Kushal Das is upstream author of various Python applications. He is a Fedora Ambassador and also member of Python Software Foundation.
He is a regular speaker in different technical conferences and also does Python workshops in various events & engineering colleges.
He also wrote a beginner Python book called Python for you and me which is targeted to the students for fast paced learning and available freely online .