Daniel Woste

Focusing currently on #sphinxneeds and #docsascode related topics for huge, distributed projects. Maintainer of several #sphinx extensions.

[Daniel Woste @DanWos]

My company is looking for a Business Developer Docs-as-Code.
It's all about defining and implementing business solutions for engineering-related companies based on Docs-as-Code and Open-Source (mainly #sphinxdoc).
https://t.co/XKAhP8oG0x

Help us to bring DaC into Industry 📕🏭

[Daniel Woste @DanWos]

We are looking for an Open-Source #rust and #Python developer for our #Sphinx ecosystem, enhancing docs-as-code for engineers in Automotive and others Industries. Helping SW devs to get the tools they love and need.

Wanna join? Have a look at https://t.co/y306FudS2J

[Daniel Woste @DanWos]

Want to understand how docs-as-code can be used in an Automotive SW project, and which process areas can benefit? Give this great analysis from Dr. Krunic a try and figure out how much time your team can save and how much quality increase you may have. https://t.co/3XS9OkDDEq

[Daniel Woste @DanWos]

@willmcgugan Ramen ;)

[Daniel Woste @DanWos]

#SphinxNeeds just got a major update to 2.0.0.🥳
A #sphinxdoc build is much faster now.

For feature and bugfixes, please take a look at the changelog: https://t.co/CysGhbUM6k

Most of the changes were done by @chrisj_sewell. Many thanks for that!

[Daniel Woste @DanWos]

@GergelyOrosz It's mostly missing internal processes and complex legal/tax situation which is stopping companies in Europe to support FOSS. Spending the first € is often tough and needs internal changes and multiple approvals. But after a process got established it normally works.

[Daniel Woste @DanWos]

@testdrivenio Ohh yes, learned about some weeks ago and was able to get 20% more speed out of some of my Sphinx extensions. Mainly as it avoids to reinitiate some docutils classes again and again. __init__() is really taking much too long in the docutils world.

[Daniel Woste @DanWos]

The data and a memory measurement of the latest commit can be found here: https://t.co/WEAB25mpM4

I'm afraid I need to get and register my own machine for gh action execution. At least the hardware is stable.

[Daniel Woste @DanWos]

There is a performance benchmark for #SphinxNeeds, which tracks how much time is needed for our doc-build.
But the needed time is jumping like hell, as the GitHub build machines seem to be not really comparable.

Any ideas on how to get comparable execution times on GitHub?

[Daniel Woste @DanWos]

@willmcgugan Thinking about to use it for a Vscode extension to show a UI in its terminal.

Ever tested how it behaves there, especially how responsive it can be to support also small terminal windows?
App would be simple buttons and some forms.

[Daniel Woste @DanWos]

Sitting in India? Maybe Bengaluru? And you are searching for a dev job at Automotive? With #opensource and #docsascode context? With daily work on #sphinxdoc and #sphinxneeds?

Here is your chance at @boschindia:
https://t.co/AIL0XxQXm8

[Daniel Woste @DanWos]

@Sumit_____77 Sorry, we mostly develop tools for the Python eco-system. No dot net.

[Daniel Woste @DanWos]

My company is hiring a docs-as-code developer. Must-haves: Python and Sphinx skills, and pleasure to work on open-source projects in the automotive industry.

Location Munich, Germany, or 100% remote
Salary: See our transparent formula on the page

https://t.co/5JFmyTM6eU

[Daniel Woste @DanWos]

@mitsuhiko No hint like "Autogenerated by AI, may not be accurate in all scenarios" for the ouput?

I see a lot of devs who just copy&paste every code example and expect to work without own thinking or further reading. And then they blame the support or docs :(

[Daniel Woste @DanWos]

@choldgraf Ohh thanks, this is really helpful. Special builders like "Sphinx-SimplePDF" need to overwrite a lot of theme configs, which are normally set for the "html" build. Your approach looks really clean and let the user still provide own stuff. Love it and will adopt it :)

[Daniel Woste @DanWos]

#Kleo gets even funnier and more "realistic" with the unofficial subtitle:

Merkel, the younger years.

[Daniel Woste @DanWos]

@osdotsystem @benbjohnson Sphinx-SimplePDF is based on weasyprint. So if the docs are Sphinx based and sources are available, maybe give it a try :)

[Daniel Woste @DanWos]

Just released Sphinx-Needs 1.2.0 for #sphinxdoc

It got a nice new directive: list2need

Use simple lists for brainstorming and then get a linked and configured need object for each line.
Can save a lot of time.

Docs: https://t.co/d52bDucF0M

[Daniel Woste @DanWos]

@reydelhumo I'm sorry, direct flight. But as it is a teaming event, I will propose Barcelona for the next trip :)

[Daniel Woste @DanWos]

I will be in #Lisbon for a complete week in March. Any good spots/events to visit, regarding #opensource, #docsascode or #sphinxdocs?

Would be happy to be part of some good technical discussions or hold some talks about #sphinxneeds and co by my own :)