Everything I've written about docs-as-code, quality and tools.https://danwos.dev/enhttps://danwos.dev/en/blog/toolchain-comparison/https://danwos.dev/en/blog/toolchain-comparison/A free toolchain comparison spreadsheet with more than 160 user requirements from automotive docs-as-code projects – for tool decisions based on facts instead of gut feeling.Tue, 15 Jul 2025 00:00:00 GMThttps://danwos.dev/en/blog/dac-automotive/https://danwos.dev/en/blog/dac-automotive/The best overview I know of docs-as-code in a professional automotive project: Dr. Momcilo Krunic's paper on an ASPICE-compliant setup with 150 engineers – republished with his permission.Tue, 23 Jan 2024 00:00:00 GMThttps://danwos.dev/en/blog/manager-pov/https://danwos.dev/en/blog/manager-pov/A fictitious conversation with a project manager of a 500-person automotive software project: why documentation quality suffers in expert tools and how docs-as-code helps.Tue, 02 Jan 2024 00:00:00 GMThttps://danwos.dev/en/blog/process-documents/https://danwos.dev/en/blog/process-documents/Document processes and workflows the docs-as-code way: a process model with Sphinx-Needs, checked by the build, linkable from project requirements – with metrics for free.Thu, 02 Dec 2021 00:00:00 GMThttps://danwos.dev/en/blog/open-needs-db/https://danwos.dev/en/blog/open-needs-db/The Prototype Fund of the German Federal Ministry of Education and Research finances Open-Needs-DB: a REST database to share requirements between projects.Mon, 29 Nov 2021 00:00:00 GMThttps://danwos.dev/en/blog/sphinx-extension-dev/https://danwos.dev/en/blog/sphinx-extension-dev/What I learned from writing Sphinx extensions: learn from other extensions, use a namespace, support parallel builds, manipulate the node tree – and let your docs be your test.Mon, 22 Nov 2021 00:00:00 GMThttps://danwos.dev/en/blog/docs-as-code-enhanced/https://danwos.dev/en/blog/docs-as-code-enhanced/Docs-as-code is more than storing docs in Git: with Sphinx-Needs, the content itself becomes code – reusable, linkable objects right inside your text.Fri, 19 Nov 2021 00:00:00 GMThttps://danwos.dev/en/blog/page-meta-data/https://danwos.dev/en/blog/page-meta-data/Who is responsible for a page, and when did it last change? Sphinx-Needs stores this as a discreet metadata object on every page – reusable in tables and filters.Thu, 18 Nov 2021 00:00:00 GMThttps://danwos.dev/en/blog/string-links/https://danwos.dev/en/blog/string-links/Write an issue ID or a user name, get a link: the string-links feature of Sphinx-Needs turns option values into links to external tools.Tue, 16 Nov 2021 00:00:00 GMThttps://danwos.dev/en/blog/pycharm-file-watchers/https://danwos.dev/en/blog/pycharm-file-watchers/See your Sphinx documentation as fast as possible: a PyCharm file watcher rebuilds the HTML on every change – with all extensions and your normal build command.Fri, 05 Nov 2021 00:00:00 GMT