#docslikecode — Public Fediverse posts
Live and recent posts from across the Fediverse tagged #docslikecode, aggregated by home.social.
-
Writing a lot of content in #ASCIIDOC and discovered #livejs to hot load my edits for preview.
Just add the script to your docinfo file when building on desktop (using fswatch to detect changes and do the rebuild on edit save).
Changes get displayed in the browser a short while later.
https://docs.asciidoctor.org/asciidoc/latest/docinfo/
Putting it here in case it helps others with #DocsLikeCode workflow
-
Writing a lot of content in #ASCIIDOC and discovered #livejs to hot load my edits for preview.
Just add the script to your docinfo file when building on desktop (using fswatch to detect changes and do the rebuild on edit save).
Changes get displayed in the browser a short while later.
https://docs.asciidoctor.org/asciidoc/latest/docinfo/
Putting it here in case it helps others with #DocsLikeCode workflow
-
"Are we heading toward an AI utopia, an AI dystopia… or something in between?
In this episode of Technical Writing Uncensored, I sit down with technical writer and blogger Fabrizio Ferri-Benedetti to talk about how AI and LLMs are changing technical writing — and what writers should actually be worried about.
Fabri writes the excellent Passo Uno blog, where he explores technical writing, AI, and the future of documentation.
Read his blog here: https://passo.unoWe discuss whether AI will replace writers, how technical writers can stay relevant, and why writers might actually become more important in an AI-driven world.
Fabri also explains why writers should think of AI as “a second language”, not something that replaces human expertise.
We also discuss:
Why AI is more like a tool (a hammer) than an autonomous intelligence
Why good documentation is essential for AI systems
Whether tech writers will become editors and prompt architects
Why writers need a “mental gym” to keep their thinking sharpThis conversation is a thoughtful look at the real impact of AI on technical writing, without the hype.
#TechnicalWritingUncensored #TechnicalWriter #TechnicalWriting #Documentarian #Documentation #WordNerds #TechComm #ContentStrategy #WritingTips #CareerAdvice #UserExperience #DocsLikeCode #TechWritingUncensored #TechCommunity #aiforwriters #ai #llm #artificialintelligence "
-
"Are we heading toward an AI utopia, an AI dystopia… or something in between?
In this episode of Technical Writing Uncensored, I sit down with technical writer and blogger Fabrizio Ferri-Benedetti to talk about how AI and LLMs are changing technical writing — and what writers should actually be worried about.
Fabri writes the excellent Passo Uno blog, where he explores technical writing, AI, and the future of documentation.
Read his blog here: https://passo.unoWe discuss whether AI will replace writers, how technical writers can stay relevant, and why writers might actually become more important in an AI-driven world.
Fabri also explains why writers should think of AI as “a second language”, not something that replaces human expertise.
We also discuss:
Why AI is more like a tool (a hammer) than an autonomous intelligence
Why good documentation is essential for AI systems
Whether tech writers will become editors and prompt architects
Why writers need a “mental gym” to keep their thinking sharpThis conversation is a thoughtful look at the real impact of AI on technical writing, without the hype.
#TechnicalWritingUncensored #TechnicalWriter #TechnicalWriting #Documentarian #Documentation #WordNerds #TechComm #ContentStrategy #WritingTips #CareerAdvice #UserExperience #DocsLikeCode #TechWritingUncensored #TechCommunity #aiforwriters #ai #llm #artificialintelligence "
-
Pleased to say that I've had a tutorial proposal accepted on how to integrate the Vale Text Linter into your Docs-As-Code technical writing project.
"Upgrade your Docs-As-Code Foo with the Vale Text Linter"
Hope to see you in Adelaide in January for a beer or two... 🍺
https://2025.everythingopen.au/
-
Pleased to say that I've had a tutorial proposal accepted on how to integrate the Vale Text Linter into your Docs-As-Code technical writing project.
"Upgrade your Docs-As-Code Foo with the Vale Text Linter"
Hope to see you in Adelaide in January for a beer or two... 🍺
https://2025.everythingopen.au/
-
if anyone has been to my various Docs As Code talks, I've moved the repo to https://gitlab.com/alecthegeek/docs-as-code (because I changed employer).
-
if anyone has been to my various Docs As Code talks, I've moved the repo to https://gitlab.com/alecthegeek/docs-as-code (because I changed employer).