photog.social is one of the many independent Mastodon servers you can use to participate in the fediverse.
🌈 An inclusive place for your photos, silliness, and convos! 🌈

Administered by:

Server stats:

249
active users

#sphinx

2 posts2 participants0 posts today

I might have finally found the tooling I was looking for on requirement engineering: sphix-needs, extension to the #sphinx documentation tooling from #python land.

I always disliked the idea of the big comercial ones to have a db for requirements - i wanted "requirements as code" sit next to the code, with the option to have full traceability back and forth from high level specs down to code and back...

This seems more then promising due to customization options

sphinx-needs.readthedocs.io/en

sphinx-needs.readthedocs.ioSphinx-Needs 5.1.0 documentation

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.

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

GitHubGitHub - DO9RE/midi2hamlibContribute to DO9RE/midi2hamlib development by creating an account on GitHub.

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 …

A sketch of the Great Sphinx of Giza, published in 1755. Note the missing nose, also seen in other sketches of the Great Sphinx of that era. Napoleon was a terrible person who did many bad things, but the nose was knocked off the Sphinx long before he ever got there.

upload.wikimedia.org/wikipedia

en.wikipedia.org/wiki/Great_Sp

#napoleon
#sphinx
#egypt