Thanks to @dereuromark, phpDocumentor Guides now has support for #djot 🎉

Djot is an improved and more precisely specified alternative to Markdown, designed to remove ambiguities and edge. It offers clearer rules, better nesting, and more consistent parsing, which makes it especially well-suited for technical documentation.

Learn more about djot: https://djot.net

https://github.com/phpDocumentor/guides-djot

#php #documentation #phpdoc

Some questions asked at home recently, plus me trying to rebuild a VM, made me realise just how badly the home services we use are documented, so I'm making a fresh start.

We have Bookstack deployed, one of the services that also needs better documentation, so I already have somewhere to store everything, I just need to make the effort and allocate some time to get the job done.

#BookStack #HomeLab #SelfHosted #Documentation

In #hardware development, if you don't document, what you are doing, you will not get a working product (besides your breadboard experiments, which you may sell?).
You want to order a circuit board?
Then you create the circuit, use layout program, maybe simulate it, export the Gerber-Files, order the board.
You automatically have your documentation, before you get the board.

With the today's approach in #software, #documentation still is seen as secondary at best.
It's the breadboard approach.

The Anatomy of a Web Performance Report, by @webperfreport.bsky.social:

https://calendar.perfplanet.com/2025/the-anatomy-of-a-web-performance-report/

#performance #documentation #webvitals #lighthouse

https://squidfunk.github.io/mkdocs-material/blog/2025/11/05/zensical/ Zensical – A modern static site generator built by the Material for MkDocs team

#documentation #zensical