Are you writing or maintaining an api doc generator for a programming language?

Lots of docs are served straight out of git. Please on't generate commit noise on every generated page.

- Don't generate a version number or time/date onto every page, stick it into the main page at most.
- Alternatively, use a CSS :before or :after rule to generate such content onto every page. Thereby only the changed CSS shows up in the commit.

Thanks.

#typedoc #javadoc #pydoctor #apidoc #doxygen

Recently I use Python more again. It seemed to not have the terrible dependency and babel-tower-of-frameworks-on-frameworks hell like JavaScript.

So I thought.

Until I wanted to make a pull request for an issue in pydoctor. All pre-commit checks are fine. Alas: I cannot find a way to just run the fucker on the command line as a smoke test.

Heaps of tons of shit installed and meter deep stack trace shit.🤮

#python #pydoctor