NRW.social

Yvonne PerkinsI had a lovely meetup coffee to start the day with fellow technical writers. Thank you to Swapnil for organising it.<a href="https://aus.social/tags/write_the_docs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#write_the_docs</a> <a href="https://aus.social/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#TechnicalWriting</a> <a href="https://aus.social/tags/WTD" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#WTD</a> <a href="https://aus.social/tags/Melbourne" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#Melbourne</a>

Miguel Afonso Caetano"Most guides to docs like code, even the ones for non-devs, assume you have some developer knowledge: maybe you're already using version control, or you've encountered build pipelines before, or you're working alongside developers.This guide is for the people who read that paragraph and wished it came with a glossary. This is docs like code for people who don't know what git is and have never installed VS Code.This post explains terminology and concepts, to help you get a mental model of what's going on. If you prefer to dive in and pick up concepts as you go, skip straight to the tips in How to learn, and come back to the conceptual info as needed."<a href="https://deborahwrites.com/blog/docs-like-code-basic-intro/" rel="nofollow noopener noreferrer" translate="no" target="_blank">https://deborahwrites.com/blog/docs-like-code-basic-intro/</a> <a href="https://tldr.nettime.org/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#TechnicalWriting</a> <a href="https://tldr.nettime.org/tags/SoftwareDocumentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#SoftwareDocumentation</a> <a href="https://tldr.nettime.org/tags/SoftwareDevelopment" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#SoftwareDevelopment</a> <a href="https://tldr.nettime.org/tags/Programming" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#Programming</a> <a href="https://tldr.nettime.org/tags/DocsAsCode" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#DocsAsCode</a> <a href="https://tldr.nettime.org/tags/Git" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#Git</a> <a href="https://tldr.nettime.org/tags/Markdown" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#Markdown</a> <a href="https://tldr.nettime.org/tags/TechnicalCommunication" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#TechnicalCommunication</a> <a href="https://tldr.nettime.org/tags/MkDocs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#MkDocs</a> <a href="https://tldr.nettime.org/tags/VSCode" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#VSCode</a>

Miguel Afonso Caetano"When evaluating documentation’s role, consider these broader strategic questions:- Strategic positioning: How does documentation support the company’s core strategic approach?- Competitive advantage: Can documentation create or enhance the company’s unique market position? What type of documentation does the competition offer?- Value proposition: How does documentation contribute to the product’s overall value for customers?- Knowledge management: How does documentation support internal knowledge retention and transfer?- Customer lifecycle: How can documentation improve customer acquisition, retention, and satisfaction?"<a href="https://www.thegooddocsproject.dev/blog/making-business-base-know-company-goals" rel="nofollow noopener noreferrer" translate="no" target="_blank">https://www.thegooddocsproject.dev/blog/making-business-base-know-company-goals</a><a href="https://tldr.nettime.org/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#TechnicalWriting</a> <a href="https://tldr.nettime.org/tags/Documentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#Documentation</a> <a href="https://tldr.nettime.org/tags/SoftwareDocumentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#SoftwareDocumentation</a> <a href="https://tldr.nettime.org/tags/TechnicalCommunication" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#TechnicalCommunication</a>

indieA pic I took on the streets of <a href="https://kolektiva.social/tags/Portland" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#Portland</a> # 363 days ago, area within walking distance of <a href="https://kolektiva.social/tags/Revolution" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#Revolution</a> Hall.I've remained publicly silent on my <a href="https://kolektiva.social/tags/WriteTheDocs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#WriteTheDocs</a> conference attendance last year because it was .... a shitty conference.And today I'll tell you why it was a shitty conference.There was a self-proclaimed "extrovert" who got up on stage and vomited bullshit about how she was representing <a href="https://kolektiva.social/tags/Nginx" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#Nginx</a>. I did not plan to give a talk, but when I woke up the last day of the conference, I really had this pressing intuition that I should speak up for the talent that was maybe intimidated ... that NO, you don't need a fucking Macbook to be a technical writer... not all technical writing is about computer-related things. But then did I find out ... what that Nginx "extrovert" was really there to do was be the shithead <a href="https://kolektiva.social/tags/censoring" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#censoring</a> the indigenous voice that wanted to get on stage and tell everybody that not all <a href="https://kolektiva.social/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#TechnicalWriting</a> has to be about <a href="https://kolektiva.social/tags/technology" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#technology</a>. But that snooty white supremacist bitch rejected this talk.

Third spruce tree on the leftEverytime I have to write "Yeah, about this button. it doesn't do anything. Don't click it. The developers didn't finish that feature in time but were too lazy to hide it before we shipped" I die a little bit inside. <a href="https://mas.to/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#TechnicalWriting</a> <a href="https://mas.to/tags/documentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#documentation</a>

Miguel Afonso Caetano"You can replace tech writers with an LLM, perhaps supervised by engineers, and watch the world burn. Nothing prevents you from doing that. All the temporary gains in efficiency and speed would bring something far worse on their back: the loss of the understanding that turns knowledge into a conversation. Tech writers are interpreters who understand the tech and the humans trying to use it. They’re accountable for their work in ways that machines can’t be.The future of technical documentation isn’t replacing humans with AI but giving human writers AI-powered tools that augment their capabilities. Let LLMs deal with the tedious work at the margins and keep the humans where they matter most: at the helm of strategy, tending to the architecture, bringing the empathy that turns information into understanding. In the end, docs aren’t just about facts: they’re about trust. And trust is still something only humans can build."<a href="https://passo.uno/whats-wrong-ai-generated-docs/" rel="nofollow noopener noreferrer" translate="no" target="_blank">https://passo.uno/whats-wrong-ai-generated-docs/</a><a href="https://tldr.nettime.org/tags/AI" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#AI</a> <a href="https://tldr.nettime.org/tags/GenerativeAI" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#GenerativeAI</a> <a href="https://tldr.nettime.org/tags/LLMs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#LLMs</a> <a href="https://tldr.nettime.org/tags/Chatbots" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#Chatbots</a> <a href="https://tldr.nettime.org/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#TechnicalWriting</a> <a href="https://tldr.nettime.org/tags/TechnicalCommunication" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#TechnicalCommunication</a> <a href="https://tldr.nettime.org/tags/SoftwareDocumentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#SoftwareDocumentation</a> <a href="https://tldr.nettime.org/tags/SoftwareDevelopment" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#SoftwareDevelopment</a> <a href="https://tldr.nettime.org/tags/TechnicalDocumentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#TechnicalDocumentation</a> <a href="https://tldr.nettime.org/tags/Docs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#Docs</a>

DJ AdamsPassionate and well written, recommended Sunday reading "What's wrong with AI-generated docs" <a href="https://passo.uno/whats-wrong-ai-generated-docs/" rel="nofollow noopener noreferrer" translate="no" target="_blank">https://passo.uno/whats-wrong-ai-generated-docs/</a> via @wallabagapp<a href="https://hachyderm.io/tags/AI" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#AI</a> <a href="https://hachyderm.io/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#TechnicalWriting</a>

jmacI wrote up a tech-writing technique I call the assertions document. It helps you rapidly develop your own understanding of a new-to-you topic by getting your subject-matter experts engaged in the docs project as quickly as possible, and even eager to help you—largely by giving them ways to tell you how you're wrong. <a href="https://masto.nyc/tags/TechWriting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#TechWriting</a> <a href="https://masto.nyc/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#TechnicalWriting</a> <a href="https://fogknife.com/2025-04-04-assert-your-way-to-stronger-technical-writing.html" rel="nofollow noopener noreferrer" translate="no" target="_blank">https://fogknife.com/2025-04-04-assert-your-way-to-stronger-technical-writing.html</a>

Miguel Afonso Caetano"The following are my suggestions regarding what else to consider for each of Daryl White’s excellent questions about choosing a toolset for documenting a software product or project.I have appended a brief guide to the main/broad categories of documentation toolsets and some of the platforms/components that are popular in each.Finally, this resource ends with a table of possible solutions for various scenarios you might find yourself in.Before we start with the existing list of questions, I want to highlight one that I think is most important of all, but which is often assumed by people who create these kinds of guides, as they tend to come from one or another world already.What are you documenting?When it comes to software technical writing, the more appropriate way to ask this might be: For what user roles is your documentation intended?For graphical end-user interfaces (GUIs), the largest range of docs tooling is available, but here some of the more commercial turnkey tools have most of their advantages.For administrator interfaces (installation, configuration, etc), again any tooling will work, but we start seeing real advantages for lightweight markup, codebase integration, and version control.For developer interfaces, docs-as-code offers significant advantages. Developers can better contribute directly, and it’s generally friendlier for coded samples. APIs (native and remote), SDKs, and CLIs are almost certainly best documented in a docs-as-code environment, even if you integrate it with a more conventional platform for end-user docs."<a href="https://gist.github.com/briandominick/d4cbe11228de0ebe31cda630976af4ef" rel="nofollow noopener noreferrer" translate="no" target="_blank">https://gist.github.com/briandominick/d4cbe11228de0ebe31cda630976af4ef</a><a href="https://tldr.nettime.org/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#TechnicalWriting</a> <a href="https://tldr.nettime.org/tags/SoftwareDocumentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#SoftwareDocumentation</a> <a href="https://tldr.nettime.org/tags/Documentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#Documentation</a> <a href="https://tldr.nettime.org/tags/DocsAsCode" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#DocsAsCode</a> <a href="https://tldr.nettime.org/tags/TechnicalCommunication" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#TechnicalCommunication</a> <a href="https://tldr.nettime.org/tags/InformationArchitecture" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#InformationArchitecture</a> <a href="https://tldr.nettime.org/tags/CCMS" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#CCMS</a>

Miguel Afonso Caetano"The accompanying diagram is intended to help you quickly decide how to document an API, but particularly a REST API. The first split is just to make sure you are looking for the right kind of API.Here is some more context to help you decide on an approach and get started."<a href="https://gist.github.com/briandominick/3ffab6be460fbde799aa34e0a42a4299" rel="nofollow noopener noreferrer" translate="no" target="_blank">https://gist.github.com/briandominick/3ffab6be460fbde799aa34e0a42a4299</a><a href="https://tldr.nettime.org/tags/API" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#API</a> <a href="https://tldr.nettime.org/tags/APIs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#APIs</a> <a href="https://tldr.nettime.org/tags/APIDesign" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#APIDesign</a> <a href="https://tldr.nettime.org/tags/REST" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#REST</a> <a href="https://tldr.nettime.org/tags/APIDocumentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#APIDocumentation</a> <a href="https://tldr.nettime.org/tags/OpenAPI" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#OpenAPI</a> <a href="https://tldr.nettime.org/tags/DocsAsCode" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#DocsAsCode</a> <a href="https://tldr.nettime.org/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#TechnicalWriting</a> <a href="https://tldr.nettime.org/tags/TechnicalCommunication" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#TechnicalCommunication</a>

Miguel Afonso Caetano"No one’s heard of a starving craftsman, just starving artists, and for a reason. Craftsmen create something people need. You’ve mastered a few important skills and moved up in the company. The important aspect here is that as you reach out to a greater community, you realize that there are plenty of people who are more skilled than you and who are still learning. Learn from them.Gaining textbook skills or collecting certifications isn’t the point anymore; it’s applying all this knowledge in practical ways. Along the journey, you need to watch out for your best career interests and make sure that what you’re doing is what you want to do. For example, many get lost in promotions that lure them away from what they like doing, whether that’s programming or writing.Finally, don’t underestimate perpetual learning. This is the key to the long road. Take time to practice, even if your job doesn’t seem to allow it. Learn new skills or apply existing skills in new ways. Along with practice comes failure, but don’t let that discourage you."<a href="https://robertdelwood.medium.com/book-review-apprenticeship-patterns-guidance-for-the-aspiring-software-craftsman-808c95ee478e" rel="nofollow noopener noreferrer" translate="no" target="_blank">https://robertdelwood.medium.com/book-review-apprenticeship-patterns-guidance-for-the-aspiring-software-craftsman-808c95ee478e</a><a href="https://tldr.nettime.org/tags/Craftsmanship" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#Craftsmanship</a> <a href="https://tldr.nettime.org/tags/Craftsman" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#Craftsman</a> <a href="https://tldr.nettime.org/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#TechnicalWriting</a> <a href="https://tldr.nettime.org/tags/SoftwareDevelopment" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#SoftwareDevelopment</a> <a href="https://tldr.nettime.org/tags/Programming" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#Programming</a> <a href="https://tldr.nettime.org/tags/TechnicalCommunication" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#TechnicalCommunication</a>

RS, Author, Novelist, Prosaist<a href="https://wetdry.world/@eblu" class="u-url mention" rel="nofollow noopener noreferrer" target="_blank">@eblu</a> <blockquote>[scanned cartoon caption reads:] EVEN WHEN THEY'RE TRYING TO COMPENSATE FOR IT, EXPERTS IN ANYTHING WILDLY OVERESTIMATE THE AVERAGE PERSON'S FAMILIARITY WITH THEIR FIELD</blockquote>I wrote technical manuals a while. Those who write the software are incapable of explaining it to a novice. Indeed, once the writer understands the software, quality goes down, not up as they edit toward concision. This is where training, self-awareness, and outside readers make a difference.<a href="https://eldritch.cafe/tags/Software" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#Software</a> <a href="https://eldritch.cafe/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#TechnicalWriting</a> <a href="https://eldritch.cafe/tags/Writer" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#Writer</a> <a href="https://eldritch.cafe/tags/Author" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#Author</a> <a href="https://eldritch.cafe/tags/WritersOfMastodon" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#WritersOfMastodon</a> <a href="https://eldritch.cafe/tags/WritingCommunity" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#WritingCommunity</a> <a href="https://eldritch.cafe/tags/Programming" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#Programming</a>

Juhis"How do you deal with code snippets in blog posts getting outdated?"Every time I give a talk about blogging for developers, I'm asked this. Now I started to take action with the first iteration of the solution.I added version metadata to my blog posts and display them at the start of the post.<a href="https://hamatti.org/posts/track-software-versions-for-technical-blog-posts/" rel="nofollow noopener noreferrer" translate="no" target="_blank">https://hamatti.org/posts/track-software-versions-for-technical-blog-posts/</a><a href="https://mastodon.world/tags/blogging" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#blogging</a> <a href="https://mastodon.world/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#TechnicalWriting</a>

Phil DavisI'm wrapping up a project, strategic & self-paced. It's been rewarding, but the finish-line push is killing me. I need to submit it. I can take it only so far on my own. Still, it's so big that I'm always finding something to fix. Dang it, today is the day.<a href="https://mastodon.nz/tags/technicalWriting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#technicalWriting</a> <a href="https://mastodon.nz/tags/techWriterLife" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#techWriterLife</a>

DacharyWhen we built tooling to audit the code examples in our documentation, we had to decide how to access the data. We had a rough idea of what content we wanted to audit, but implementation required more than a rough idea. We also had to decide how to work with this content and what to do with the resulting data.This is part three in an eight-part series about auditing the code examples in our documentation.<a href="https://dacharycarey.com/2025/03/16/audit-access-data/" rel="nofollow noopener noreferrer" translate="no" target="_blank">https://dacharycarey.com/2025/03/16/audit-access-data/</a><a href="https://dacharycarey.social/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#TechnicalWriting</a> <a href="https://dacharycarey.social/tags/Documentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#Documentation</a> <a href="https://dacharycarey.social/tags/DeveloperDocs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#DeveloperDocs</a>

Yvonne PerkinsThis article about 'invalidating management styles' really resonates with me as I recently have had a year where any initiative that I showed (and there were many) was met by a manager who said ' that is not what we need' or 'our engineers won't like that' or the other myriad problems he can find with my initiative. The worst response was 'there's too much of you in it' (translation: they don't want me to present, but he can present).I ended up being out of ideas and miserable. All along I was networking within the organisation and found a secondment with another team. On the 1st morning a depressing weight lifted off my shoulders. I never expect perfection in others, but I love this team and its managers. We even have lunch together at least once a week because we enjoy each other's company . <a href="https://aus.social/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#TechnicalWriting</a> <a href="https://aus.social/tags/WriteTheDocs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#WriteTheDocs</a> <a href="https://www.theguardian.com/commentisfree/2025/mar/16/a-managers-flat-response-to-gails-initiative-left-her-deflated-feeling-seen-is-fundamental-to-human-wellbeing" rel="nofollow noopener noreferrer" translate="no" target="_blank">https://www.theguardian.com/commentisfree/2025/mar/16/a-managers-flat-response-to-gails-initiative-left-her-deflated-feeling-seen-is-fundamental-to-human-wellbeing</a>

Miguel Afonso CaetanoHire more technical writers: Isn't the solution obvious?? :-D"Documentation was especially valuable when it came time to refactor code by providing a blueprint that saved time and improved focus. The researchers found that good documentation “ensures that refactoring efforts are directed towards tangible and specific quality improvements, maximizing the value of each refactoring action and ensuring the long-term maintainability and evolution of the software.”As our co-founder Joel Spolsky put it, documentation encodes generational wisdom that goes beyond the simple specs of what was built. “Think of the code in your organization like plumbing in a building. If you hire a new superintendent to manage your property, they will know how plumbing works, but they won’t know exactly how YOUR plumbing works,” said Spolsky. “Maybe they used a different kind of pump at their old site. They might understand how the pipes connect, but they won’t know you have to kick the boiler twice on Thursday to prevent a leak from springing over the weekend.”If we know from decades of research that documentation is a key component of creating and maintaining quality code, why is it so often considered low-priority work developers would rather avoid if they can be writing code instead? (...) By embracing AI-powered documentation tools, development teams can significantly reduce toil work, mitigate technical debt, and foster an environment where developers can thrive. Wise organizations will also keep humans in the loop, ensuring that documentation engineers or technical writers act as editors and stewards of any AI-generated documentation, preventing errors or hallucinations from creeping into otherwise accurate docs."<a href="https://tldr.nettime.org/tags/Documentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#Documentation</a> <a href="https://tldr.nettime.org/tags/SoftwareDocumentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#SoftwareDocumentation</a> <a href="https://tldr.nettime.org/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#TechnicalWriting</a> <a href="https://tldr.nettime.org/tags/SoftwareDevelopment" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#SoftwareDevelopment</a> <a href="https://tldr.nettime.org/tags/Programming" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#Programming</a> <a href="https://stackoverflow.blog/2024/12/19/developers-hate-documentation-ai-generated-toil-work/" rel="nofollow noopener noreferrer" translate="no" target="_blank">https://stackoverflow.blog/2024/12/19/developers-hate-documentation-ai-generated-toil-work/</a>

Miguel Afonso Caetano"[T]he lack of a clear entry path makes the profession less accessible, contributing to a lack of diversity in tech writing teams. If technical writing is to remain relevant in an industry that values innovation and inclusion, it needs to welcome new voices.Fixing this problem won’t happen overnight, but there are steps companies and the broader industry can take to rebuild the pipeline for entry-level talent:- Reintroduce mentorship programs. - Companies can pair senior writers with juniors to share knowledge and help newcomers build confidence. - Redefine “entry-level” roles. - Stop asking for years of experience in entry-level job postings. - Focus instead on transferable skills like writing, research, and adaptability. - Create apprenticeships or internships. - Paid opportunities to learn on the job can give aspiring writers the experience they need to land full-time roles. Invest in training. - Documentation teams should have budgets for upskilling new hires — not just hiring pre-trained professionals."<a href="https://willkelly.medium.com/how-the-technical-writing-profession-betrayed-entry-level-tech-writers-8a0c05617efd" rel="nofollow noopener noreferrer" translate="no" target="_blank">https://willkelly.medium.com/how-the-technical-writing-profession-betrayed-entry-level-tech-writers-8a0c05617efd</a><a href="https://tldr.nettime.org/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#TechnicalWriting</a> <a href="https://tldr.nettime.org/tags/TechnicalCommunication" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#TechnicalCommunication</a> <a href="https://tldr.nettime.org/tags/SoftwareDocumentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#SoftwareDocumentation</a> <a href="https://tldr.nettime.org/tags/SoftwareDevelopment" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#SoftwareDevelopment</a> <a href="https://tldr.nettime.org/tags/Docs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#Docs</a> <a href="https://tldr.nettime.org/tags/Documentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#Documentation</a>

Miguel Afonso Caetano"Tech comms can be a business, but thinking is not selling: it requires intellectual freedom and courage. Leaving these conversations to engineers risks turning technical communication into a caricature of itself, a four-quadrant fantasy devised to lure developers into thinking that documentation is a simple pastime, yet another Jira task.Only independent thought can help us progress and navigate uncertainty, including our future in a world where AI is injected into every domain that deals with words. Technical writers must own their problems and the conversations around them, or they will slowly fade into irrelevance, their problems absorbed by other disciplines that have more pressing problems to focus on. And if you’re reading that we should lobby more, you’re not wrong: defending knowledge requires power.”<a href="https://tldr.nettime.org/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#TechnicalWriting</a> <a href="https://tldr.nettime.org/tags/TechnicalCommunication" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#TechnicalCommunication</a> <a href="https://tldr.nettime.org/tags/SoftwareDocumentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#SoftwareDocumentation</a> <a href="https://tldr.nettime.org/tags/CriticalThinking" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#CriticalThinking</a> <a href="https://passo.uno/tech-writing-depth-issue/" rel="nofollow noopener noreferrer" translate="no" target="_blank">https://passo.uno/tech-writing-depth-issue/</a>

Frühere Suchanfragen

Suchoptionen

Verwaltet von:

Serverstatistik:

#technicalwriting