Writing documentation for AI: best practices

https://docs.kapa.ai/improving/writing-best-practices

#HackerNews #WritingDocumentation #AI #BestPractices #TechWriting #DocumentationTips

🌍 DevOps isn't just YAML and Jenkins pipelines.
It's invisible labor, platform stability, late-night rollbacks, and fighting outages so users never notice.

I wrote about the real work DevOps engineers do — the kind no one talks about.

👉 https://medium.com/@ismailkovvuru/what-devops-engineers-really-do-the-work-no-one-talks-about-22cc60005362

#DevOps #SRE #CloudEngineering #Observability #PlatformEngineering #InfrastructureAsCode #TechWriting #DevOpsLife #aws

Broke prod once, never again 😉

Just dropped my new article — git survival notes for the real ones

https://www.devops.pink/git-branches-how-to-not-break-prod-and-stay-alive/

#git #DevOps #SoftwareEngineering #TechWriting

Why I Wrote the Beam Book

https://happihacking.com/blog/posts/2025/why_I_wrote_theBEAMBook/

#HackerNews #Why #I #Wrote #the #Beam #Book #BeamBook #Hacking #Community #TechWriting #SoftwareDevelopment

Recurring #TechWriting issue that I still haven't found a good solution for:

Is anyone aware of a decently reliable automation for reformatting #Markdown text that previously used line length limits of 80 characters and forced line wraps, to one sentence per line?

Must preserve all Markdown formatting including tables and fenced code blocks.

(If you think this is trivial and can be solved with a sprinkling of regex — nope.)

Boosts appreciated!

This is what I think about AI's impact on writing as well. My belief is that we have to weather the storm of overly eager decisions by non-experts to replace people with AI ... and to quote a friend, "pick up the pieces later".

With writing, sure, it's really easy to vomit out a brochure copy, but you still need a writer to give it a human voice and to check for hallucinations. For high-level, complex tech writing that I do good luck trying to generate that.

Clients will sniff fakery a mile away and avoid your company like the plague.

We need to apply AI to our workflows in a more realistic way, not in a sci-fi way.

https://youtu.be/fJGNqnq-aCA?si=cE0uPBw-_mT4XYvt

#AI #Tech #Writing #techwriting

New Story Just Dropped on Medium!

“From Idea to Deployment: How SDLC Powers DevOps Success” 🛠️
Ever wondered how a solid Software Development Life Cycle (SDLC) forms the backbone of modern DevOps?
This story breaks it down in a simple, practical way — no fluff, just real insights.

👉 Read now: https://medium.com/@jyostnavya.jakkapu/from-idea-to-deployment-how-sdlc-powers-devops-success-b6991eb4c94c

Let’s build better software, faster.
🔁 Boost if you find it helpful!

#DevOps #SDLC #CloudComputing #TechWriting #CICD

MathML with Pandoc

https://leancrew.com/all-this/2025/05/mathml-with-pandoc/

#HackerNews #MathML #Pandoc #HTML #LaTeX #TechWriting

🧬 Ghostwritten Infrastructure: From Org Mode to Hardened YAML #Emacs #OrgMode #Ansible #Yaml #IaC
#LiterateDevOps #OrgBabel #TangleThatYaml #DeadSwitchWay
#DevOpsTools #LinuxAutomation #CyberGhostOps
#TechWriting #TomITCafe #SilentOps

http://tomsitcafe.com/2025/04/19/%f0%9f%a7%ac-ghostwritten-infrastructure-from-org-mode-to-hardened-yaml/