#pydoctor — Public Fediverse posts
Live and recent posts from across the Fediverse tagged #pydoctor, aggregated by home.social.
-
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.
-
CW: rant
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.🤮