Posts tagged sphinx

Process documents with Sphinx-Needs

Documenting processes is often a separate task in companies. Done by an extra department/team for processes, workflows and tools (PMT). And published in specific formats, which are not reusable or referencable by project specific documentations. But being able to link project requirements to process steps would help developers to understand the need for such requirements.

This post explains how the docs-as-code approach can be used to document processes and workflows.

../../_images/processes_with_sphinx_needs.png

Read more ...


Open-Needs-DB gets funded

The Prototype Fund supports and finances Open-Needs-DB from March to September 2022.

The Federal Ministry of Education and Research created this program to support developers in Germany during the creation of digital prototypes for topics in the area of Civic Tech, Data Literacy, IT Security and Software Infrastructure.

../../_images/open_needs_funded.png

Read more ...


Sphinx Extension Development: Tips & Tricks

In the last year I have written some Sphinx extensions and figured out some stuff, which I want to share here.

First of all, the documentation for Sphinx extension development is not so detailed. There is a tutorial available by the Sphinx team, but the used example project is quite simple.

../../_images/sphinx_extension_dev.png

Read more ...


Docs-as-Code Enhanced

For most of us “Docs-as-Code” mostly means to store the documentation files beside the project sources in git. Also editing the sources in an already used IDE and using the CI system to build it, are 2 important use cases why docs-as-code is chosen to create documentation.

But these features have nothing to do with the documentation content itself. What if the content itself can be treated as code? What if the content / documentation language provides features, which we already know from our programming languages?

../../_images/docs_as_code_enhanced.png

Read more ...


Page meta data in Sphinx

In bigger Sphinx projects, written by hundreds of authors, you often need to store additional data to somehow have the overall page creation and update process under control.

This data can be stored and maintained as meta-data on top of each rst file.

../../_images/page_meta_data.png

Read more ...


String2Link transformation with Sphinx-Needs

Sphinx-Needs got a new cool feature to easily create links of a given string for options. The string-links feature.

This allows to just set e.g. a github issue id and get a link to exactly this issue in the final docs.

Read more ...


PyCharm File Watchers for Sphinx projects

I often have the case that I want to see my documentation as fast as possible.

And I know there are “Preview” IDE-Extensions available, which want to solve this problem.

../../_images/1_general_settings.png

Read more ...


Page reactivation

For a long, long time I had no private representation on the internet, as most of my work was done for open-source projects, so that I added my thoughts to their websites and documentation pages.

Now, I’m planing something big ;)

Read more ...


Job advertisement for Sphinx-Needs

I just have detected the first job advertisement, which asks for Sphinx-Needsas skill. Yeah 🥳

The job is for a Docs-As-Code Development engineer at Bosch in Leonberg, Germany.

../../_images/bosch-sphinx-needs.png

Read more ...