ajf
Why are the documentations of tools that are meant to create documentations so terrible? #pdoc #sphinx #python
Jul 1, 2024 at 10:06amWeb
Show threadForza4  Jul 1, 2024
@clumpytree Because it are not remade with the finished documentation creation tool... or use that to discover errors ;)
Show threadDave PearsonJul 1, 2024
@clumpytree mkdocstrings fights that trend, I feel: https://mkdocstrings.github.io/
Overview - mkdocstrings

Automatic documentation from sources, for MkDocs.

Show threadTimothée Mazzucotelli Jul 25, 2024

@davep @clumpytree

Thanks Dave 😅

It's a legitimate question. My answer, as someone who creates docs tools and documents them, is that creating docs tools and writing docs are two very different things! I'm good with Python, but that doesn't mean I'm good at writing docs ^^

We have a saying in French: le cordonnier est le plus mal chaussé. The shoemaker has the worst shoes?