I built adocfmt, an opinionated AsciiDoc formatter for Java and the command line.
- One sentence per line for clean diffs
- Idempotent, code blocks stay untouched
- pre-commit hook and GitHub Action for CI
github.com/dheid/adocfmt
#AsciiDoc #Java #DocsAsCode
- One sentence per line for clean diffs
- Idempotent, code blocks stay untouched
- pre-commit hook and GitHub Action for CI
github.com/dheid/adocfmt
#AsciiDoc #Java #DocsAsCode
GitHub - dheid/adocfmt: An opinionated AsciiDoc formatter for Java and the command line.
An opinionated AsciiDoc formatter for Java and the command line. - dheid/adocfmt
github.com
November 9, 2026 at 10:08 AM
I built adocfmt, an opinionated AsciiDoc formatter for Java and the command line.
- One sentence per line for clean diffs
- Idempotent, code blocks stay untouched
- pre-commit hook and GitHub Action for CI
github.com/dheid/adocfmt
#AsciiDoc #Java #DocsAsCode
- One sentence per line for clean diffs
- Idempotent, code blocks stay untouched
- pre-commit hook and GitHub Action for CI
github.com/dheid/adocfmt
#AsciiDoc #Java #DocsAsCode
How we replaced an outdated engineering wiki with Docs-as-Code using Markdown, Mermaid, GitHub Actions, and automated documentation workflows. #docsascode
Building a Docs-as-Code Workflow With Markdown, Mermaid, and GitHub Actions
hackernoon.com
October 29, 2026 at 4:49 PM
How we replaced an outdated engineering wiki with Docs-as-Code using Markdown, Mermaid, GitHub Actions, and automated documentation workflows. #docsascode
How we replaced an outdated engineering wiki with Docs-as-Code using Markdown, Mermaid, GitHub Actions, and automated documentation workflows. #docsascode
Building a Docs-as-Code Workflow With Markdown, Mermaid, and GitHub Actions
hackernoon.com
October 29, 2026 at 4:49 PM
How we replaced an outdated engineering wiki with Docs-as-Code using Markdown, Mermaid, GitHub Actions, and automated documentation workflows. #docsascode
Vom 10. – 12. November kann man mich auf der tekom-Jahrestagung treffen.
Werde auch einen Vortrag über ein Migrationsprojekt halten („Wie gelingt eine Docs-as-Code-Kernsanierung – mühsam renovieren oder gleich alles abreißen?“).
https://jahrestagung.tekom.de/tagung
#tekom […]
Werde auch einen Vortrag über ein Migrationsprojekt halten („Wie gelingt eine Docs-as-Code-Kernsanierung – mühsam renovieren oder gleich alles abreißen?“).
https://jahrestagung.tekom.de/tagung
#tekom […]
Original post on social.tchncs.de
social.tchncs.de
September 25, 2026 at 9:50 AM
Vom 10. – 12. November kann man mich auf der tekom-Jahrestagung treffen.
Werde auch einen Vortrag über ein Migrationsprojekt halten („Wie gelingt eine Docs-as-Code-Kernsanierung – mühsam renovieren oder gleich alles abreißen?“).
https://jahrestagung.tekom.de/tagung
#tekom […]
Werde auch einen Vortrag über ein Migrationsprojekt halten („Wie gelingt eine Docs-as-Code-Kernsanierung – mühsam renovieren oder gleich alles abreißen?“).
https://jahrestagung.tekom.de/tagung
#tekom […]
Every file in the pages folder becomes a page. Home pinned first, the rest alphabetical.
Adding a Contributors page is one commit. No nav config, no route to register, no sidebar to hand edit. The filename is the page title.
#GitHub #DocsAsCode #OpenSource
Adding a Contributors page is one commit. No nav config, no route to register, no sidebar to hand edit. The filename is the page title.
#GitHub #DocsAsCode #OpenSource
September 5, 2026 at 3:02 PM
Every file in the pages folder becomes a page. Home pinned first, the rest alphabetical.
Adding a Contributors page is one commit. No nav config, no route to register, no sidebar to hand edit. The filename is the page title.
#GitHub #DocsAsCode #OpenSource
Adding a Contributors page is one commit. No nav config, no route to register, no sidebar to hand edit. The filename is the page title.
#GitHub #DocsAsCode #OpenSource
A file called .slate, a folder called pages, and a push to main. That is the setup.
No build step, no generator to keep fed, no workflow YAML. Content stays plain text next to the code, so it diffs and reviews like code does.
#GitHub #DocsAsCode #OpenSource
No build step, no generator to keep fed, no workflow YAML. Content stays plain text next to the code, so it diffs and reviews like code does.
#GitHub #DocsAsCode #OpenSource
September 4, 2026 at 7:01 AM
A file called .slate, a folder called pages, and a push to main. That is the setup.
No build step, no generator to keep fed, no workflow YAML. Content stays plain text next to the code, so it diffs and reviews like code does.
#GitHub #DocsAsCode #OpenSource
No build step, no generator to keep fed, no workflow YAML. Content stays plain text next to the code, so it diffs and reviews like code does.
#GitHub #DocsAsCode #OpenSource
Documentation-as-code tools gained traction with docs living next to source and deploying through the same pipeline. Docs rot is now visible in the same PR review that causes it
#DocsAsCode #Documentation #DevEx
#DocsAsCode #Documentation #DevEx
August 20, 2026 at 4:26 AM
Documentation-as-code tools gained traction with docs living next to source and deploying through the same pipeline. Docs rot is now visible in the same PR review that causes it
#DocsAsCode #Documentation #DevEx
#DocsAsCode #Documentation #DevEx
Docs as Code Fundamentals course new lesson: Editing, collaboration, contribution.
You’re managing a docs team or running a documentation project? This lesson will help you!
👉 docskit.link/rtkc1o
#DocsKit #platformOS #DocsAsCode #TechComm #OpenSourceDocs #Collaboration #Documentation
You’re managing a docs team or running a documentation project? This lesson will help you!
👉 docskit.link/rtkc1o
#DocsKit #platformOS #DocsAsCode #TechComm #OpenSourceDocs #Collaboration #Documentation
October 20, 2025 at 8:08 PM
Docs as Code Fundamentals course new lesson: Editing, collaboration, contribution.
You’re managing a docs team or running a documentation project? This lesson will help you!
👉 docskit.link/rtkc1o
#DocsKit #platformOS #DocsAsCode #TechComm #OpenSourceDocs #Collaboration #Documentation
You’re managing a docs team or running a documentation project? This lesson will help you!
👉 docskit.link/rtkc1o
#DocsKit #platformOS #DocsAsCode #TechComm #OpenSourceDocs #Collaboration #Documentation
Keep your docs consistent with automation + linters. New lesson in our Docs as Code Fundamentals course: how tools like Vale, markdownlint, lychee, axe-core, DocsKit + EkLine help you catch issues early + save time.
👉 docskit.link/gej2jhű
#platformOS #DocsAsCode #DocsKit #EkLine
👉 docskit.link/gej2jhű
#platformOS #DocsAsCode #DocsKit #EkLine
September 9, 2025 at 8:39 PM
Keep your docs consistent with automation + linters. New lesson in our Docs as Code Fundamentals course: how tools like Vale, markdownlint, lychee, axe-core, DocsKit + EkLine help you catch issues early + save time.
👉 docskit.link/gej2jhű
#platformOS #DocsAsCode #DocsKit #EkLine
👉 docskit.link/gej2jhű
#platformOS #DocsAsCode #DocsKit #EkLine
New lesson in the Docs as Code Fundamentals course!
Module 3 – Lesson 1: The review process
Learn how PRs drive collaboration, what reviewers look for, and how review culture builds quality + trust.
👉 docskit.link/wyfddm
#DocsKit #platformOS #DocsAsCode #Documentation #TechnicalWriting
Module 3 – Lesson 1: The review process
Learn how PRs drive collaboration, what reviewers look for, and how review culture builds quality + trust.
👉 docskit.link/wyfddm
#DocsKit #platformOS #DocsAsCode #Documentation #TechnicalWriting
August 27, 2025 at 10:59 AM
New lesson in the Docs as Code Fundamentals course!
Module 3 – Lesson 1: The review process
Learn how PRs drive collaboration, what reviewers look for, and how review culture builds quality + trust.
👉 docskit.link/wyfddm
#DocsKit #platformOS #DocsAsCode #Documentation #TechnicalWriting
Module 3 – Lesson 1: The review process
Learn how PRs drive collaboration, what reviewers look for, and how review culture builds quality + trust.
👉 docskit.link/wyfddm
#DocsKit #platformOS #DocsAsCode #Documentation #TechnicalWriting
Writing for both humans and AI? Your docs need structure, clarity, and consistency.
Our latest post shows how we are making AI-ready docs scalable and effective.
🔗 platformos.link/6aj0ay
#platformOS #DocsKit #DocsAsCode #AItools
Our latest post shows how we are making AI-ready docs scalable and effective.
🔗 platformos.link/6aj0ay
#platformOS #DocsKit #DocsAsCode #AItools
Structuring Documentation for AI Comprehension blog page | platformOS
Structuring Documentation for AI Comprehension
platformos.link
August 14, 2025 at 1:16 PM
Writing for both humans and AI? Your docs need structure, clarity, and consistency.
Our latest post shows how we are making AI-ready docs scalable and effective.
🔗 platformos.link/6aj0ay
#platformOS #DocsKit #DocsAsCode #AItools
Our latest post shows how we are making AI-ready docs scalable and effective.
🔗 platformos.link/6aj0ay
#platformOS #DocsKit #DocsAsCode #AItools
In our latest article, we explore why modern docs must work for both humans and machines. We share best practices, real-world examples, and how we're embedding these principles into our workflows.
platformos.link/1j3h82
#platformOS #TechnicalWriting #AI #DocsAsCode
platformos.link/1j3h82
#platformOS #TechnicalWriting #AI #DocsAsCode
Writing for Humans and Machines: Why Docs Now Serve Two Audiences blog page | platformOS
Writing for Humans and Machines: Why Docs Now Serve Two Audiences
platformos.link
August 8, 2025 at 1:18 PM
In our latest article, we explore why modern docs must work for both humans and machines. We share best practices, real-world examples, and how we're embedding these principles into our workflows.
platformos.link/1j3h82
#platformOS #TechnicalWriting #AI #DocsAsCode
platformos.link/1j3h82
#platformOS #TechnicalWriting #AI #DocsAsCode
AI is changing how we write, review, and manage docs, but teams still share the same concerns.
At platformOS, we’re already integrating AI into our workflows and client work.
👉 platformos.link/ujwm1x
#AI #TechComm #DocsAsCode #DocumentationStrategy #Cherryleaf
At platformOS, we’re already integrating AI into our workflows and client work.
👉 platformos.link/ujwm1x
#AI #TechComm #DocsAsCode #DocumentationStrategy #Cherryleaf
AI Adoption in Technical Communication: Measured Progress in 2025 blog page | platformOS
AI Adoption in Technical Communication: Measured Progress in 2025
platformos.link
July 7, 2025 at 7:31 PM
AI is changing how we write, review, and manage docs, but teams still share the same concerns.
At platformOS, we’re already integrating AI into our workflows and client work.
👉 platformos.link/ujwm1x
#AI #TechComm #DocsAsCode #DocumentationStrategy #Cherryleaf
At platformOS, we’re already integrating AI into our workflows and client work.
👉 platformos.link/ujwm1x
#AI #TechComm #DocsAsCode #DocumentationStrategy #Cherryleaf
Thank you to our growing number of subscribers! 🎉
We published the next lesson in our Docs as Code Fundamentals course: Module 2 - Lesson 3: Style guide.
Watch it here for free 👉 docskit.link/e90y4w
#DocsKit #platformOS #DocsAsCode #Documentation #TechnicalWriting
We published the next lesson in our Docs as Code Fundamentals course: Module 2 - Lesson 3: Style guide.
Watch it here for free 👉 docskit.link/e90y4w
#DocsKit #platformOS #DocsAsCode #Documentation #TechnicalWriting
May 29, 2025 at 5:51 PM
Thank you to our growing number of subscribers! 🎉
We published the next lesson in our Docs as Code Fundamentals course: Module 2 - Lesson 3: Style guide.
Watch it here for free 👉 docskit.link/e90y4w
#DocsKit #platformOS #DocsAsCode #Documentation #TechnicalWriting
We published the next lesson in our Docs as Code Fundamentals course: Module 2 - Lesson 3: Style guide.
Watch it here for free 👉 docskit.link/e90y4w
#DocsKit #platformOS #DocsAsCode #Documentation #TechnicalWriting
Thank you to our growing number of subscribers! 🎉
We published the next lesson in our Docs as Code Fundamentals course: Module 2 - Lesson 2: Topic types.
Watch it here for free 👉 docskit.link/toffxm
#DocsKit #platformOS #DocsAsCode #Documentation #TechnicalWriting
We published the next lesson in our Docs as Code Fundamentals course: Module 2 - Lesson 2: Topic types.
Watch it here for free 👉 docskit.link/toffxm
#DocsKit #platformOS #DocsAsCode #Documentation #TechnicalWriting
April 17, 2025 at 8:33 PM
Thank you to our growing number of subscribers! 🎉
We published the next lesson in our Docs as Code Fundamentals course: Module 2 - Lesson 2: Topic types.
Watch it here for free 👉 docskit.link/toffxm
#DocsKit #platformOS #DocsAsCode #Documentation #TechnicalWriting
We published the next lesson in our Docs as Code Fundamentals course: Module 2 - Lesson 2: Topic types.
Watch it here for free 👉 docskit.link/toffxm
#DocsKit #platformOS #DocsAsCode #Documentation #TechnicalWriting
New lesson alert for our free Docs as Code Fundamentals course: Markup Languages! 📣
Master Markdown, streamline conversions, and choose the right tools for your projects.
👉 docskit.link/qe4gd6
#DocsKit #platformOS #DocsAsCode #Markdown #TechnicalWriting
Master Markdown, streamline conversions, and choose the right tools for your projects.
👉 docskit.link/qe4gd6
#DocsKit #platformOS #DocsAsCode #Markdown #TechnicalWriting
March 5, 2025 at 5:06 PM
New lesson alert for our free Docs as Code Fundamentals course: Markup Languages! 📣
Master Markdown, streamline conversions, and choose the right tools for your projects.
👉 docskit.link/qe4gd6
#DocsKit #platformOS #DocsAsCode #Markdown #TechnicalWriting
Master Markdown, streamline conversions, and choose the right tools for your projects.
👉 docskit.link/qe4gd6
#DocsKit #platformOS #DocsAsCode #Markdown #TechnicalWriting
Migrating docs? Make it easy with DocsKit + MrScraper! Automate extraction & conversion for faster, scalable results.
👉 https://platformos.link/fcvjwj
##platformOS ##DocsKit ##MrScraper ##Documentation ##DocumentationMigration ##Automation ##DocsAsCode
👉 https://platformos.link/fcvjwj
##platformOS ##DocsKit ##MrScraper ##Documentation ##DocumentationMigration ##Automation ##DocsAsCode
Streamlining Documentation Migration with DocsKit and MrScraper | platformOS
Streamline documentation migration with DocsKit and MrScraper, automating content extraction, conversion, and management for efficiency and scalability.
platformos.link
October 10, 2024 at 4:59 PM
Migrating docs? Make it easy with DocsKit + MrScraper! Automate extraction & conversion for faster, scalable results.
👉 https://platformos.link/fcvjwj
##platformOS ##DocsKit ##MrScraper ##Documentation ##DocumentationMigration ##Automation ##DocsAsCode
👉 https://platformos.link/fcvjwj
##platformOS ##DocsKit ##MrScraper ##Documentation ##DocumentationMigration ##Automation ##DocsAsCode
Diana Lakatos, Director of Documentation at platformOS, has been honored with the 2024 UKTC Merit Award for her book, “Crafting Docs for Success”!
👉 https://platformos.link/77arn1
##platformOS##TechnicalCommunication ##ISTC ##UKTCMeritAward ##DocsAsCode ##DocumentationExcellence
👉 https://platformos.link/77arn1
##platformOS##TechnicalCommunication ##ISTC ##UKTCMeritAward ##DocsAsCode ##DocumentationExcellence
platformOS Celebrates UKTC Merit Award for “Crafting Docs for Success” | platformOS
We celebrate Diana Lakatos’ UKTC Merit Award for her book ‘Crafting Docs for Success,’ honoring her contributions to developer documentation excellence.
platformos.link
October 3, 2024 at 2:23 PM
Diana Lakatos, Director of Documentation at platformOS, has been honored with the 2024 UKTC Merit Award for her book, “Crafting Docs for Success”!
👉 https://platformos.link/77arn1
##platformOS##TechnicalCommunication ##ISTC ##UKTCMeritAward ##DocsAsCode ##DocumentationExcellence
👉 https://platformos.link/77arn1
##platformOS##TechnicalCommunication ##ISTC ##UKTCMeritAward ##DocsAsCode ##DocumentationExcellence
Over the past few years, #Pinterest has been embracing #DocsAsCode across the organization.
The outcome?
✅ Improved documentation quality
✅ Higher team satisfaction
✅ A transformed culture of collaboration, quality control, and discoverability
🔗 bit.ly/3ZWF2aj
#InfoQ #SoftwareArchitecture
The outcome?
✅ Improved documentation quality
✅ Higher team satisfaction
✅ A transformed culture of collaboration, quality control, and discoverability
🔗 bit.ly/3ZWF2aj
#InfoQ #SoftwareArchitecture
June 17, 2025 at 8:28 AM
Over the past few years, #Pinterest has been embracing #DocsAsCode across the organization.
The outcome?
✅ Improved documentation quality
✅ Higher team satisfaction
✅ A transformed culture of collaboration, quality control, and discoverability
🔗 bit.ly/3ZWF2aj
#InfoQ #SoftwareArchitecture
The outcome?
✅ Improved documentation quality
✅ Higher team satisfaction
✅ A transformed culture of collaboration, quality control, and discoverability
🔗 bit.ly/3ZWF2aj
#InfoQ #SoftwareArchitecture
Workflow I have been adopting to keep access (and ability to edit) #DocsAsCode for some of my repositories on mobile:
1. Setup the docs/ folder as a SilverBullet.plus space.
2. Create a @pikapods.bsky.social #SilverBullet instance for it.
3. Configure SB+ to sync to it and done.
I now edit my docs
1. Setup the docs/ folder as a SilverBullet.plus space.
2. Create a @pikapods.bsky.social #SilverBullet instance for it.
3. Configure SB+ to sync to it and done.
I now edit my docs
Sync — SilverBullet+
SilverBullet+ is a programmable personal knowledge database built on markdown files — private by default, with live preview, wiki links, and Lua scripting.
silverbullet.plus
July 2, 2026 at 3:09 PM
Workflow I have been adopting to keep access (and ability to edit) #DocsAsCode for some of my repositories on mobile:
1. Setup the docs/ folder as a SilverBullet.plus space.
2. Create a @pikapods.bsky.social #SilverBullet instance for it.
3. Configure SB+ to sync to it and done.
I now edit my docs
1. Setup the docs/ folder as a SilverBullet.plus space.
2. Create a @pikapods.bsky.social #SilverBullet instance for it.
3. Configure SB+ to sync to it and done.
I now edit my docs
Gute KI braucht guten Kontext.
Im Fullstack Live Event zeigt Falk Sippach, warum Docs-as-Code mit ADRs, arc42 & C4 die Grundlage für KI-gestützte Softwareentwicklung bildet.
📅 17.08.2026
👉 https://entwickler.de/live-events/ki-braucht-architektur/
#DocsAsCode #SoftwareArchitecture #AI
Im Fullstack Live Event zeigt Falk Sippach, warum Docs-as-Code mit ADRs, arc42 & C4 die Grundlage für KI-gestützte Softwareentwicklung bildet.
📅 17.08.2026
👉 https://entwickler.de/live-events/ki-braucht-architektur/
#DocsAsCode #SoftwareArchitecture #AI
August 6, 2026 at 9:30 AM
Gute KI braucht guten Kontext.
Im Fullstack Live Event zeigt Falk Sippach, warum Docs-as-Code mit ADRs, arc42 & C4 die Grundlage für KI-gestützte Softwareentwicklung bildet.
📅 17.08.2026
👉 https://entwickler.de/live-events/ki-braucht-architektur/
#DocsAsCode #SoftwareArchitecture #AI
Im Fullstack Live Event zeigt Falk Sippach, warum Docs-as-Code mit ADRs, arc42 & C4 die Grundlage für KI-gestützte Softwareentwicklung bildet.
📅 17.08.2026
👉 https://entwickler.de/live-events/ki-braucht-architektur/
#DocsAsCode #SoftwareArchitecture #AI
🎨 Beauty Diagram now runs in your terminal.
`npx @beauty-diagram/cli` — no install, no sign-in: beautify, export to SVG / PNG, batch a whole docs folder, or share a link, across 9 themes.
`npm i -g @beauty-diagram/cli`
→ www.beauty-diagram.com/developers/cli
#cli #devtools #mermaid #docsascode
`npx @beauty-diagram/cli` — no install, no sign-in: beautify, export to SVG / PNG, batch a whole docs folder, or share a link, across 9 themes.
`npm i -g @beauty-diagram/cli`
→ www.beauty-diagram.com/developers/cli
#cli #devtools #mermaid #docsascode
Log in
Log in to save work, export diagrams, and manage your plan.
www.beauty-diagram.com
June 15, 2026 at 2:20 PM
🎨 Beauty Diagram now runs in your terminal.
`npx @beauty-diagram/cli` — no install, no sign-in: beautify, export to SVG / PNG, batch a whole docs folder, or share a link, across 9 themes.
`npm i -g @beauty-diagram/cli`
→ www.beauty-diagram.com/developers/cli
#cli #devtools #mermaid #docsascode
`npx @beauty-diagram/cli` — no install, no sign-in: beautify, export to SVG / PNG, batch a whole docs folder, or share a link, across 9 themes.
`npm i -g @beauty-diagram/cli`
→ www.beauty-diagram.com/developers/cli
#cli #devtools #mermaid #docsascode
