I used the nice #pdoc https://pdoc.dev/ package to **really** easily generate my #python package documentation.
I am hitting the walls of this simplicity and looking for alternatives.
I tried #sphinx a while ago and didn't really liked it.
#mkdocs seems nice.
any ideas about one of those or advantages/experiences?

I generally like working with reStructuredText for technical documentation. I use it a lot both at work and on my own projects.

But the little detail that a single space off on the indentation turns something into a block quote, which happens *all the time* in lists with sub points, is rather annoying. They should have stuck with ">" for block quotes instead.

I see these accidental block quotes all the time in documentation.

Earlier this year, I switched over to using the #denote #emacs package for managing the content on my #sphinx powered blog.

If you are interested in such things, I finally got around to writing up some notes on how I did this

https://www.alcarney.me/blog/2025/blogging-with-sphinx-and-denoteel/

Im Projekt #SPHINX haben das Fraunhofer ISE und Freesuns eine Pilotlinie für innovative PV-#Dachziegel mit Matrix-Schindeltechnologie aufgebaut.

Die Module sind effizient, ästhetisch und ideal für #Bestandsbauten und #Denkmalschutz. Durch versetzt angeordnete #Solarzellen erreichen sie höhere Leistung und bessere #Verschattungstoleranz.

Die EU-geförderte Entwicklung soll gebäudeintegrierte #Photovoltaik-Elemente schneller marktreif machen.

https://www.ise.fraunhofer.de/de/presse-und-medien/presseinformationen/2025/pilotlinie-fuer-pv-dachziegel-mit-matrix-schindeltechnologie-aufgebaut.html

Hawkmoth v0.21.0 is out.

Hawkmoth is a Sphinx extension to incorporate formatted C and C++ source code comments written in
reStructuredText into Sphinx based documentation.

v0.21.0 has improved support for documenting function pointer typedefs, fixes issues in looking up parsed results, and enables REUSE compliance.

https://jnikula.github.io/hawkmoth/stable/

I'm exploring ways to improve audio preprocessing for speech recognition for my [midi2hamlib](https://github.com/DO9RE/midi2hamlib) project. Do any of my followers have expertise with **SoX** or **speech recognition**? Specifically, I’m seeking advice on: Best practices for audio preparation for speech recognition. SoX command-line parameters that can optimize audio during recording or playback.
https://github.com/DO9RE/midi2hamlib/blob/main/tests/speech_menu.sh #SoX #SpeechRecognition #OpenSource #AudioProcessing #ShellScripting #Sphinx #PocketSphinx #Audio Retoot appreciated.

What do y’all use to render your API docs in Sphinx?

I’m nearly ready to just give up and use ReDoc/Swagger/etc, but I’d prefer something that integrates with the existing docs. But I just spent an hour poking at sphinxcontrib-openapi and its OpenAPI v3 support is just very patchy and sad …

Did you know that the famous Great #Sphinx of Giza didn't just lose her nose?

She also lost her #beard.

It was long & braided, like that of pharaohs.

The Sphinx was also originally multicoloured.

whooo prime space on the latest planet #dyne: https://news.dyne.org/planet-dyne-s2025-e03/ sphinx promoted and they run their own #sphinx server! wooo

\o/ @dyne now hosts the first public sphinx server not under my control at sphinx.dyne.org:443
their ltsigkey is

`TnQHEiiJtFXqhUskqAxtIhG/xlk9t79BXyLcofai32g=`

https://sphinx.pm/servers.html

i'm gonna move the current public v1 sphinx server on pwd.ctrlc.hu from port 443 to 2443, and a new v2 server will be set up on port 443 very very soon.

#python #sphinx #documentation

#Sphinx release 8.2.0 (2025-02-18)

- https://www.sphinx-doc.org/en/master/changes/index.html#release-8-2-0-released-feb-18-2025

- https://www.sphinx-doc.org/en/master/changes/index.html#features-added

- https://github.com/sphinx-doc/sphinx/releases/tag/v8.2.0

- https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#collapsible-admonitions

Thank you Adam Turner ! (https://github.com/AA-Turner, Python Committer and #PEP Editor. Maintainer of Sphinx and #Docutils)

thought it might be nice to sign #sphinx releases with #minisign and #ssh #eddsa keys, straight outta sphinx. minisign #privkeys are okish (they do need 40 B of entropy, 8 extra for a "keyid"). but did you know, that in ssh the public key is stored 3x in the ed25519 private #key? one time i can understand (could be 0 though), but 3 times? what have they been drinking? #fileformats