Sphinx won't bite you! Documenting Python code - Damian Skrzypczak - code::dive 2018
The importance of a well-documented code is known to anyone who has ever encountered a code without documentation... sometimes their own.
Right next to readability of the code lays its documentation. Every programmer knows that even a single example of code usage can put them on the right track and by that save hours of coding experiments. It's just always better to know what to expect from the code before you run it, right?
Due to its dynamic nature, Python requires particularly good documentation. Fortunately, docstrings, reStructuredText, and Sphinx are there to help us facilitate the code documenting process.
Throughout this presentation, I will introduce you to the process of writing documentation using the reStructuredText format and converting it into HTML with the help of the Sphinx tool.
https://codedive.pl/index/speaker/nam...
Watch video Sphinx won't bite you! Documenting Python code - Damian Skrzypczak - code::dive 2018 online without registration, duration hours minute second in high quality. This video was added by user code::dive conference 07 February 2019, don't forget to share it with your friends and acquaintances, it has been viewed on our site 3,434 once and liked it 30 people.