this post was submitted on 10 Mar 2025
2 points (100.0% liked)

Programming

0 readers
9 users here now

A magazine created for the discussion of computer programming-related topics.

Rules

Please keep submissions on topic and of high quality. No image posts, no memes, no politics. Keep the magazine focused on programming topics not general computing topics. Direct links to app demos (unrelated to programming) will be removed. No surveys.

founded 2 years ago
MODERATORS
 

"Technical documentation as an industry is at a crossroads. If we don't invest in the next generation of experts—consultants, educators, and documentation strategists—we're looking at a future where companies try to automate away problems they don't fully understand, and the only available documentation training is a two-hour webinar hosted by someone who just discovered Markdown last week.

So, if you're an industry veteran, here's my plea: write it all down before you retire. Mentor someone. Record a video explaining why metadata matters. Start a blog. Write a book (or three). Please do something to ensure that when you finally sign off for good, the rest aren't left googling "How to create a sustainable documentation strategy " and getting a bunch of AI-generated nonsense in return.

Otherwise, the future of tech comm might be one long, desperate, less-than-helpful Slack thread."

https://www.thecontentwrangler.com/p/the-great-documentation-brain-drain?r=8sej&amp%3Butm_campaign=post&amp%3Butm_medium=web

#TechnicalWriting #SoftwareDocumentation #SoftwareDevelopment #Programming #BrainDrain

top 1 comments
sorted by: hot top controversial new old
[–] [email protected] 1 points 6 days ago

Im actively working against this at work as we speak. There truly seems to be a lack of understanding around how significantly good technical documentation can improve a company. In all aspects. But, no, let us just replace writers with AI and burned out BAs and engineers. Sounds smart.