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...
Смотрите видео Sphinx won't bite you! Documenting Python code - Damian Skrzypczak - code::dive 2018 онлайн без регистрации, длительностью часов минут секунд в хорошем качестве. Это видео добавил пользователь code::dive conference 07 Февраль 2019, не забудьте поделиться им ссылкой с друзьями и знакомыми, на нашем сайте его посмотрели 3,434 раз и оно понравилось 30 людям.