🚯 No More Markdown 🚯

Well, it's certainly not going away any time soon, but it doesn't have to be the default. While it's easily a majority of the docs formats that I have to use, it's not my favorite.

Perhaps in an ideal world it would be AsciiDoc or LaTeX All The Time, but we don't live in that world, oh well 💋

In the interim, here's someone who wrote about the topic which seems worth sharing. Interesting points, ja?

- Why You Shouldn’t Use “Markdown” for Documentation: https://ericholscher.com/blog/2016/mar/15/dont-use-markdown-for-technical-docs/

#engineering #software #oss #foss #markdown #documentation

🚯 No More Markdown 🚯

Well, it's certainly not going away any time soon, but it doesn't have to be the default. While it's easily a majority of the docs formats that I have to use, it's not my favorite.

Perhaps in an ideal world it would be AsciiDoc or LaTeX All The Time, but we don't live in that world, oh well 💋

In the interim, here's someone who wrote about the topic which seems worth sharing. Interesting points, ja?

- Why You Shouldn’t Use “Markdown” for Documentation: https://ericholscher.com/blog/2016/mar/15/dont-use-markdown-for-technical-docs/

#engineering #software #oss #foss #markdown #documentation

BookStack v25.07 is now here with a bundle of improvements:

📝 Markdown Plaintext Input Option
✏️ New Comment/Description Editor
🔧 New WYSIWYG Editor Improvements
📋 Improved Changelog Input
📦 ZIP Import/Export API Endpoints
🏷️ Parent Tag Classes
📱 Multi-Column Layout Refinements
🔐 Better Permission Generation
🌍 Nepali Language & Updates

https://www.bookstackapp.com/blog/bookstack-release-v25-07/

#Documentation#SelfHosted#OpenSource#KnowledgeManagement

BookStack v25.07 is now here with a bundle of improvements:

📝 Markdown Plaintext Input Option
✏️ New Comment/Description Editor
🔧 New WYSIWYG Editor Improvements
📋 Improved Changelog Input
📦 ZIP Import/Export API Endpoints
🏷️ Parent Tag Classes
📱 Multi-Column Layout Refinements
🔐 Better Permission Generation
🌍 Nepali Language & Updates

https://www.bookstackapp.com/blog/bookstack-release-v25-07/

#Documentation#SelfHosted#OpenSource#KnowledgeManagement

Astro Docs is redefining Must-See TV... well, for docs 😅

Tomorrow on Talking and Doc'ing:

- Fixing an Astro Docs SEO issue using Starlight's new routeData.

- Writing docs for a feature that doesn't exist (and that we don't yet even know how we're going to implement) to drive its development!

Subscribe to the @astro YouTube channel and be notified when we go live (Thurs 9ET / 14:00 CET)

https://www.youtube.com/watch?v=6VcV_K9Qlck

#astrojs #documentation #opensource

Did you ever have a look at the excellent #documentation of #Purism products?

https://docs.puri.sm/

One of the products of Purism is the #Librem5. The Librem 5 is a #Linux phone that runs the #PureOS operating system.

This phone is built up from the bottom to provide #privacy and software #freedom. No #surveillance by the manufacturer, free and #opensource (#FOSS) is their standard.

I use a Librem 5 as my daily phone.

#DigitalSovereignty#DigitalAutonomy

Did you ever have a look at the excellent #documentation of #Purism products?

https://docs.puri.sm/

One of the products of Purism is the #Librem5. The Librem 5 is a #Linux phone that runs the #PureOS operating system.

This phone is built up from the bottom to provide #privacy and software #freedom. No #surveillance by the manufacturer, free and #opensource (#FOSS) is their standard.

I use a Librem 5 as my daily phone.

#DigitalSovereignty#DigitalAutonomy