Вижу тут дискуссию по теме, которая вроде не должна побуждать к этому.
Я бы начал все таки с официальной документации и PEP257
.
В PEP257 определено соглашение, как мы документируем.
Далее, из написанных согласно pep257
строк документации, можно сгенерировать полноценную доку с помощью модуля pydoc.
Все остальное, это инструменты для расширения возможностей и удобства, либо принятые в ограниченном кругу условности, которые используют все. Кстати, если не прописаны дополнения к документации, то через пару смен команды разработки, все приходит к неуправляемому хаосу (мнение).
По вашим ссылкам:
- Документирование для веб служб, основаных на REST API. Надо понимать, что далеко не каждое приложение подходит под данную технологию
- Кастомный способ, написанный для удобства автором ответа (ничего плохого, можно делать все удобства под себя)
- Официальная дока для
pydoc
, упомянутый в ответе.