r/technicalwriting • • Oct 28 '25

AWS tech writers majorly impacted by today's layoffs

995 Upvotes

I am one of the thousands of people laid off today from across Amazon/AWS. There are many of us from the Technical Content Experience (TCX) org that are impacted. I won't go into specifics beyond that. I am sharing my thoughts but I am just one person.

I have read lots of the discussions here about the impact of AI and have seen many comments stating that AI can't replace us simply because it can't do everything we do. Well I'm here to say that it doesn't matter that AI can't do everything we do. It doesn't matter that the quality is noticeably worse than our writing. It doesn't matter that it doesn't know all the overhead and confusing internal systems that we use to get our docs out the door. Corporate leadership doesn't care about any of those things. They will give you AI tools, train "you" to use them (it's really the other way around - you're training IT), tell you that it'll make your life easier, and still let you go in the end. I'm sorry to be all doom-and-gloom, but I want people to know that this is the reality for one of the biggest writing organizations out there. AWS Service Docs writers are the sharpest, wittiest, and most supportive writers I have worked with. I am sad to lose them as colleagues.

Be kind to one another.


r/technicalwriting • • Dec 02 '24

HUMOUR Everytime single time I use Word

Post image
542 Upvotes

-shakes fist in the air-


r/technicalwriting • • Mar 23 '24

If not for this, technical writing wouldn’t exist.

Post image
449 Upvotes

r/technicalwriting • • Jan 17 '26 Bravo

HUMOUR respect

438 Upvotes

r/technicalwriting • • May 02 '20

A list of open source projects with volunteer documentation opportunities

376 Upvotes

(This is an update to my original post from 2018)

People who are trying to get technical writing experience are often told to find an open source project and volunteer to write their documentation. Writing documentation for an open source project can give you valuable experience that you can use as a starting point for a technical writing career. If nothing else, it will help you figure out if technical writing is a good career choice for you.

However, finding an open source project to volunteer for can be a daunting task. This is a list of various open source projects looking for volunteers in order to help you find a way to contribute.

Read this first for background: How to Contribute to Open Source - https://opensource.guide/how-to-contribute/

The Write the Docs Slack workspace - https://www.writethedocs.org/slack/ will sometimes have volunteer opportunities listed in their #community-help-wanted channel. The #open-source channel has opportunities listed from time to time too. Several of the volunteer opportunities listed here (Grafana, Mautic, Spinnaker, and PowerShell) were suggested by members of the WtD Slack.

Resources from Amruta Ranade:

Her YouTube channel is here: https://www.youtube.com/channel/UCKsaZMjb3lsLe5YtasDifuA

Beginner resources

If you're completely new to both technical writing and open source, these would be the best place to start. These opportunities are with established open source projects with a formal setup in place to allow people to volunteer.

Mid-level and advanced resources

These projects require a higher degree of technical skill with various open source tools than the beginner resources. They are not out of reach for a beginner, but you will need to make more of an effort to learn how to use the software required to contribute to the project.

The tools needed to contribute to the mid-level and advanced resources, such as Git, Markdown, or AsciiDoc, are tools that are used on a daily basis by technical writers across the globe. Knowing how to use these tools can be very useful in your career.


r/technicalwriting • • Oct 17 '24

HUMOUR Creating documentation in Word is tedious

Post image
367 Upvotes

Saw this post and thought it was relatable. I’ve used Microsoft word for a lot of projects in the past, and I can’t say that I enjoy using it to create documentation that is 30+ pages with images/figures.

Who here likes to create documentation using Word?


r/technicalwriting • • Mar 04 '24

Just no.

Post image
352 Upvotes

r/technicalwriting • • Feb 04 '25

I'm finally a Technical Writer

279 Upvotes

I want to shamelessly share a milestone since I don't post on my socials.. and I'm sort of trying to push myself to feel proud. After obtaining a BA in English and working my way through manufacturing for 5 years, last spring I accepted a short contract as a TW. After that contract ended, I was called by a recruiter for a TW level 2 role contract at a global manufacturer. Very fortunate.

This was the career I wanted so badly. I was unemployed, sick, broke, and depressed for most of 2020. It's not the perfect role, and I think if I never did administrative/tech writing at my previous company, euphoria would've hit me hard. So this job and title just feels eh. I lurked on here a lot back in 2019. I am one of you now.


r/technicalwriting • • Feb 07 '24

The "Technical Writer" bait-and-switch

Post image
270 Upvotes

r/technicalwriting • • Sep 24 '24

HUMOUR hmm.exe

Post image
268 Upvotes

r/technicalwriting • • Jun 06 '24

MEME "Must be proficient in Microsoft Office Suite"

Post image
267 Upvotes

r/technicalwriting • • Oct 27 '21 Mindblown

[Career FAQs] Read this before asking about salaries, what education you need, or how to start a technical writing career!

266 Upvotes

Welcome to r/technicalwriting! Please read through this thread before asking career-related questions. We have assembled FAQs for all stages of career progression. Whether you're just starting out or have been a technical writer for 20 years, your question has probably been answered many times already.

Doing research is a huge part of being a technical writer (TW). If it's too tedious to read through all of this then you probably won't like technical writing.

Also, just try searching the subreddit! It really works. E.g. if you're an English major, searching for english major will return literally hundreds of posts that are probably highly relevant to you.

If none of the posts are relevant to your situation, then you are welcome to create a new post. Pro-tip: saying something like I reviewed the career FAQs will increase your chances of getting high-quality responses from the r/technicalwriting community.

Thank you for respecting our community's time and energy and best of luck on your career journey!

(A note on the organization: some posts are duplicated because they apply to multiple categories. E.g. a post from a new grad double majoring in English and CS would show up under both the English and CS sections.)

Education

Internships, finding a job after graduating, whether Masters/PhDs are valuable, etc.

General

Technical writing

English

Creative writing

Rhetoric

Communications

Chemistry

Graphic design

Information technology

Computer science

Engineering

French

Spanish

Linguistics

Physics

Instructional design

Training

Certificates, books to read, etc.

Resumes

What to include, getting feedback on your resume, etc.

Portfolios

How to build a portfolio, where to host it, getting feedback on your portfolio, etc.

Interviews

How to ace the interview, what kinds of questions to ask, etc.

Salaries

Determining whether a salary is fair, asking for a raise, etc.

Transitions

Breaking into technical writing from a different field.

General

Instructional design

Information technology

Engineering

Software developer

Writing

Technical program manager

Customer support

Journalism

Project manager

Teaching

Teacher

Property manager

Animation

Administrative assistant

Data analyst

Manufacturing

Product manager

Social media

Speech language pathologist

Advancement

You got the job (congrats). Next steps for growing your TW career.

Exits

Leaving technical writing and pursuing another career.

General

Project management

Business process manager

Marketing

Teaching

Product manager

Software developer

Business analyst

Writing

Accounting

Demand

State of the TW job market, what types of TW specialties are in highest demand, which industries pay the most, etc.


r/technicalwriting • • Apr 19 '25

JOB 87 applicants in two weeks

264 Upvotes

Really starting to see how brutal it is out there. We opened an entry level tech writing job in Wisconsin two weeks ago, and have a total of 87 applicants. Applicants ranged from recent college grads to PhD's with years of experience.

The sad thing is, sometime next week we will be cancelling that open requisition. The company is starting to realize the catastrophic damage Chinese tariffs will cause and halted any hiring.

I have to imagine that at least some of those applicants are Trump voters. Congratulations, you've played yourselves. Unless something changes in maybe a months time, you've probably also played me and I'll be joining you in the unemployment line. Tariffic thinking.


r/technicalwriting • • May 20 '26

I promise you that technical writers are still needed

255 Upvotes

I recently started at a well known company, and let me tell ya what, the amount of documentation they have vs the amount of usable and relevant documentation is shocking.

They have AI now, and you might be thinking: well there it is. No need for me.

One part of the conversation surrounding AI that seems overlooked and something I’ve clocked immediately is that the AI is only as good as its training material, and lemme tell ya what! 99% of the documentation that they’re training these things on are pretty fucking bad, and it leads to a lot of errors!

This has resulted in me convincing my management that we need a manual, human review of almost every process and procedure doc available.

I know it seems dire, but you will find writing jobs. It’s a position they think they can wish away, but they can’t.


r/technicalwriting • • Jun 30 '26

I hate my job now that I'm being told to use AI

251 Upvotes

I actually liked writing, editing, learning a new topic, working with SMEs...

Now I'm told to use to take the prompt that my manager gives to me, to apply against the engineers' report (which is illegible as it's now AI slop), run the output through a second AI to edit it, then dump it back into review (the engineers are also using AI to speed up review).

I went to school for this. I engaged in self improvement and learning. I found the job challenging and stimulating. Now it's bureaucratic hell. I'm not doing anything I couldn't have done straight out of high school.

When I complain I'm just told to use the tools.

I feel like Ian McKellen on the set of LotR who started crying, saying he didn't go into acting to yell at a green screen. No art, no effort, only product. Could product be better with effort? Doesn't matter; use tools. Use the same way as everyone else. Make product.

Could things be better? Could we innovate or use the tools to automate the boring repetitive stuff like checking layout against the style guide? No. All of it. AI does work now; all I do is make the prompt go.

How soul crushing is that? Other than being thankful I'm employed at all, what is the dang point?


r/technicalwriting • • Jul 15 '22

Today I learned that the "loading circle" is actually called a "throbber." I'm absolutely just going to call it "the loading circle" in my doc 😭

234 Upvotes

Just a little humor for this Friday. Throbber sounds a tad too sexy for a quick start guide... not to mention my users will have no idea what we're referring to.


r/technicalwriting • • Sep 12 '20

I am a unicelllular organism who wants to transition to tech writing. Where do I start?

Post image
214 Upvotes

r/technicalwriting • • Sep 06 '22

MEME a meme for these trying times

Post image
211 Upvotes

r/technicalwriting • • Jul 20 '26

Why is every post people thinking they can move in to tech writing as a higher paying, lower effort, easier career when they have almost no relevant or useful background that would make the switch even remotely viable?

206 Upvotes

Yeah, this is a rant, because it is moronic to see all these late bloomers thinking that oh I wrote a poem in highschool I can do tech writing, or oh I want something easy and remote to do on the side of my actual hobby.

I have been crafting my resume, portfolio, and spending hours upon hours learning specific niche and domain-relevant things for tech writing, and it is laughable to think that people see it as a "well my creative writing degree job didnt work so this will" pov.

Hate to break it to you, this job isn't easy, it requires tons of ​knowledge you don't get from a basic english degree, and it is competitive.

(This isn't to dissuade people, it isn't to support all the AI doomists either, it is just to say that if you obviously don't have the dedication or determination from your prior role, then you won't make it here either)


r/technicalwriting • • Jul 19 '24

MEME Based or nah

Post image
206 Upvotes

r/technicalwriting • • Apr 10 '26 Thanks Popcorn

AI - Artificial Intelligence After 21 years I'm ready to call it.

204 Upvotes

I'm in software. I've worked for tiny companies and ones you own stock in. I've seen us go from Microsoft Word to to docs-as-code and now to "self-healing docs" and agents. I've been a principal writer. I've always been an FTE (lucky there) and heck, I even have a good job now. I'm aware of my fortune in this market.

But I need to work for quite a bit longer, since I've been laid off so much that retirement is nowhere close. I'm a cost center, so whenever dumb ideas don't work out or they want to do a dividend, or can't get more funding for company pivot #46, out I go.

When the Department of Labor forecasts us with flat growth for the next decade, when Snowflake, MinIo, and others wreck their whole docs teams, when the most senior docs person at Google gets cut, when our entire field reeks of that "gonna get replaced" smell even if it's not feasible yet—and this is in addition to us always having needed to defend our value: it's enough already.

One of our professional societies vanished. The other is mainly two things: 1) smart people who are trying to change the narrative and will likely remain when we shrink, and 2) people who can't get a job.

One of our most well-known recruiters called this a dying field years ago and just this month essentially said most of us should pivot.

How can I possibly think there's enough legs here to get me to retirement?

  • Option 1: Ride it til the wheels fall off and then throw a dart at a map and get a job at Costco.

  • Option 2: Find that pivot before dementia sets in. Yeah, I don't have one either.

What I do know is that after this time doing it, I'm sick of pretending this ain't umbrellas in front of hurricanes and even sicker of defending my value amid the impermanence.

I view my tech career as a broken promise and absolutely regret every second, because it won't see me to the end of my working life and hasn't gained me the so-called American dream.

I'm a writer. I became a tech writer to monetize the thing I'm best at. But words aren't valued in business now. Information might be, but that isn't the same thing.

This is not an "AI bad" post. I use that stuff every day and would do so even if ordered not to. It's chocolate ice cream. Yeah, it sometimes makes things up, but so did Steve Jobs. It also makes impossible stuff possible.

Four years ago, I could ask Napoleon's birthday and get a 10,000-word college essay about Australian marmots. I'm pretty sure they're not endemic there, so that's worse.

Now I can find gaps in my docs that I've missed, stuff in the codebase to document that I wouldn't even understand, and heck... apparently crack major enterprise software with Mythos (good on Anthropic for holding that back).

Yes, I have to check it. So can a dude in Singapore.

If that's the way it's going within this timeframe, if this is the worst it will ever be, we have no chance. Some of us will be shepherds or centaurs, since no product manager has the patience or inclination to sweat the details and all developers know is that their code works. Some folks are already doing that kind of thing.

But, I'll bet that's going to be half or less. Do those numbers.

I think the penetration/adoption of the shepherd/centaur approach is the only thing preventing those numbers.

Most companies have no idea how to use AI, but they'll figure it out. They have good incentive: being able to fire all the people who cost ~20% more than their salary just from health insurance and give cash money to their execs and shareholders.

Well, I need health insurance. I don't "love" documentation (though I do appreciate it and admire the many who're smarter and better at it). I work to live.

There's a literal "burn their houses down" angle here that I won't pursue since this is a public forum and also a place where brigades start and are always lame.

The actual purpose of this post is just to say we're mainly screwed—in the most explicit way possible—not using any minimalism whatsoever, because I do that all day.

And, to do so as someone who's done this a long time and isn't just starting out or a doomer by nature.

Why? For therapeutic value and as a warning to people considering this nutty thing we do.


r/technicalwriting • • Apr 18 '25

HUMOUR We don't need no tech writers!

196 Upvotes

A few years ago, the company I work for acquired a new subsidiary. We visited them early on to offer our services. The boss insisted their engineers could write better instructions than we could. Flash forward three years and they agree that maybe we could help after all. This is part of the copy I received, written by a degreed engineer with English as their first and only language. (I'm transcribing to protect the guilty.)

"The RESET button is a multi-function switch. Each function activated determines on the length of time the pushbutton is held depressed by the user."

That's not just passive voice, that's submissive.


r/technicalwriting • • Mar 23 '26

it’s over

189 Upvotes

i’ve worked remotely for a software company for a few years. our ceo has been telling us we should use AI everyday since 2024.

i have an overzealous coworker that can code really well which is great for them, but has continuously pushed the standard for our team out of reach. it honestly feels like they use this role as a way to be a software engineer without the stress and high paced schedule. when i interviewed for this job it said explicitly to be able to read code but not write it; they are constantly scripting things. they “automated” our Release Notes a year ago (writers have to copy the ai output, edit, then post it in customer facing file)

we got Claude licenses recently…..i was hoping that it would take them a couple months to even pursue this but now they’ve built a skill that can document features via JIRA….what is my job then lol?

it’s so frustrating because i’m the youngest person on my team, a first generation college student, a child of immigrants. this is literally my chance to build stability and they’re just ripping it away. layoffs feel imminent.

i’m grateful that i have another career to pivot into, however that really should not be the reality less than a decade after graduating undergrad. what is going to happen to everyone else who solely focused on this career?


r/technicalwriting • • May 11 '21

It's called "after care" y'all and it's important. Who wants to kick us off with their APIs?

Post image
186 Upvotes