r/technicalwriting • u/Extreme-Secretary596 • 1d ago
r/technicalwriting
•
u/kaycebasques
•
Oct 27 '21
[Career FAQs] Read this before asking about salaries, what education you need, or how to start a technical writing career!
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 Internship (26 Dec 2024)
- help pls (01 Dec 2024)
- How do you find a job in this field as an upcoming Graduate? (13 Nov 2024)
- Is a master's degree a good entry way, if your bachelor's degree is unrelated? (12 Nov 2024)
- Questions about the job (24 Jul 2024)
- Interviewing for technical writer role as PhD grad (13 Jul 2024)
- Are college degrees still relevant? (26 Jun 2024)
- Internship (17 May 2024)
- Rising sophomore looking to become tech writer (12 May 2024)
Technical writing
- Any advice? (05 Jan 2025)
- Any advice for someone majoring in Professional and Technical Writing? (19 Dec 2024)
- Student looking for advice! (10 Nov 2024)
- Graduating in May, feel unprepared (03 Sep 2024)
- PhD Programs (please read the entire post) (03 Sep 2024)
- Should I get a Master's degree in Tech Writing? (02 Sep 2024)
English
- Likelyhood of getting an entry technical writing position with BA English and needing to relearn skillset after 3 years? (03 Jan 2025)
- Advice for a college student aspiring to technical writing? (11 Dec 2024)
- Would it be best to major in Technical Writing or would it be better to major in English? (01 Nov 2024)
- Question about college degrees: Computer Science or English (29 Oct 2024)
- Techincal writing cert/bachelor in english (24 Oct 2024)
- Internship Search (13 Sep 2024)
- Concentration or Minor (10 Sep 2024)
- Bad Timing? (06 Aug 2024)
- Advice for how to enter the field (25 Jun 2024)
- Is this career path worth it? (13 Jun 2024)
Creative writing
- Tech writing career as a fresher (25 Dec 2024)
- Question about getting first job (02 Aug 2024)
- How can Iget my first job as a technical writer? (27 May 2024)
Rhetoric
- Degree but no experience, help! (23 Dec 2024)
Communications
- Need Advice (20 Nov 2024)
- Approaching TW, Questions (13 Aug 2024)
- I want to break into technical writing but I don't know how to start. (02 Jul 2024)
Chemistry
- How likely is it for a chemist to transition successfully into technical writing? (12 Nov 2024)
- Chemistry BS interested in technical writing (10 Jul 2024)
- Getting into technical writing with a biochemistry background (03 Jun 2024)
Graphic design
- Help I don’t know if I want to do Technical Communication.. (09 Nov 2024)
- Struggled at my first internship, lost on where to go from here (08 Oct 2024)
Information technology
- IT grad here, I want to get into technical writing (05 Nov 2024)
Computer science
- Question about college degrees: Computer Science or English (29 Oct 2024)
- Where Can Technical Writing Take Me? (02 Sep 2024)
- Career shift (21 Jun 2024)
- Full time employment (05 Jun 2024)
- Where do I start from ? (25 May 2024)
Engineering
- Should I consider technical writing? (25 Sep 2024)
- Lean Technical Writing? (13 Jun 2024)
- How can Iget my first job as a technical writer? (27 May 2024)
French
- Prepping for Job Search (16 Jul 2024)
Spanish
- Prepping for Job Search (16 Jul 2024)
Linguistics
- Prepping for Job Search (16 Jul 2024)
Physics
- Master's Degree vs Certificate (02 Jul 2024)
Instructional design
- Technical writing vs. Instructional design (06 May 2024)
Training
Certificates, books to read, etc.
- Professional Writing Technologies - What software do tech writers need to know? (16 Dec 2024)
- Is DITA knowledge necessary for beginners? (14 Dec 2024)
- Courses and Social anxiety for TW (07 Dec 2024)
- What courses or skills should I learn? (05 Dec 2024)
- Advice on Preparing for New Job (02 Dec 2024)
- technical writing roadmap (26 Nov 2024)
- What should I read? (19 Nov 2024)
- ISO Certification Recommendations (19 Nov 2024)
- Recommend some good Udemy courses for Technical Writer who's just begun the journey (18 Nov 2024)
- Any advice on where to start? (18 Nov 2024)
- Starting my first Tech Writing job with no formal experience, looking for advice! (12 Nov 2024)
- Anybody here have their PMP? Looking for advice as I’m set to take my exam in a few weeks (12 Nov 2024)
- Expanding my skill set - where to start? (28 Oct 2024)
- Which certification is more worth my time? (10 Oct 2024)
- Technical Writing Certification? (09 Oct 2024)
- I need a niche (API documentation?) (03 Oct 2024)
- For anyone who has taken a course to get certified and enjoyed it, which one did you take? (02 Oct 2024)
- Technical Writer branch out (23 Sep 2024)
- Where can I learn IT Technical Writing best practices? (20 Sep 2024)
- Write the Docs conference (17 Sep 2024)
- What degree would you reccomend if I want to get better at communicating complex ideas? (16 Sep 2024)
- Searching for authentic examples of poor or weak tech communication - memos, emails, reports, etc. (06 Sep 2024)
- Tech writing certificate (04 Sep 2024)
- Learning API documentation (02 Sep 2024)
- Looking for feedback on this course (02 Sep 2024)
Resumes
What to include, getting feedback on your resume, etc.
- Resume Advice Needed (09 Dec 2024)
- A bad look? (24 Nov 2024)
- Too much experience? (14 Nov 2024)
- Resume review (05 Nov 2024)
- Resume Tips (30 Oct 2024)
- Resume Review Help (28 Oct 2024)
- Recent Work Experience Irrelevant - Does it Matter? (15 Oct 2024)
- Resume Advice for an Aspiring TW (27 Sep 2024)
- Resume skills section questions (20 Sep 2024)
- Technical Writers Resume (28 Aug 2024)
- Are cover letters really necessary? (20 Aug 2024)
- Here’s what you’re forgetting when you’ve got no bites after applying to hundreds of tech writing jobs, plus 3 resume strategies (15 Aug 2024)
- Recruiters/Hiring Managers: Portfolio included in resume? (14 Aug 2024)
- Updating resume to reflect new company name. (14 Jul 2024)
- Please let me know what you think of my Resume, would love to hear critic i'm trying to get myself an interview in this market, let me know any tips and recommendation. Thank you! (06 Jul 2024)
- How do I get back to the workforce as a Technical Writer after a huge gap in my resume? (28 Jun 2024)
- Resume Help (25 Jun 2024)
- Resume Help (19 Jun 2024)
- Feedback on Resume? (28 May 2024)
- Should I put Udemy courses on my resume/Linkedin? (22 May 2024)
- Resume Help (20 May 2024)
Portfolios
How to build a portfolio, where to host it, getting feedback on your portfolio, etc.
- Trying to break into Tech Writing..... (31 Dec 2024)
- Revising existing documents for portfolio (27 Dec 2024)
- Newbie: Portfolio and Qualifications (09 Dec 2024)
- Portfolio - Document Visibility (01 Dec 2024)
- Can anyone review my manual (26 Nov 2024)
- What can I submit as technical writing samples? (14 Nov 2024)
- Writing Portfolio Organization (13 Nov 2024)
- Beginner portfolio piece? (07 Nov 2024)
- Critique my content writing skills (06 Nov 2024)
- Good TW Samples for Portfolio? (13 Oct 2024)
- Experienced Technical Writer With No Portfolio (10 Oct 2024)
- Would it be appropriate to link a test TW document that I’ve written, to get some feedback as a newbie? (05 Oct 2024)
- What looks good in a portfolio that isn't related to your actual job? (02 Oct 2024)
- Can I get some feedback on this. (20 Sep 2024)
- Rebuilding my portfolio- suggestions? (19 Sep 2024)
- Boosting Portfolio (10 Sep 2024)
- Bad technical writing (04 Sep 2024)
- How do you store your samples? (04 Sep 2024)
- Portfolio advice (01 Sep 2024)
- How do you apply for jobs if you don’t have a portfolio? (17 Aug 2024)
Interviews
How to ace the interview, what kinds of questions to ask, etc.
- Multiple offers? (10 Dec 2024)
- Out of work for 6 months following layoffs, completely burnt out from interviewing (25 Nov 2024)
- Do you trust recruiters? (19 Nov 2024)
- Seemed like a really good interview and then Ghosted. (18 Nov 2024)
- Rejection call? (14 Nov 2024)
- AI Interview questions (12 Nov 2024)
- What Questions Should I Ask in a Tech Writing Interview? (11 Nov 2024)
- Job Interview and API Documentation (10 Nov 2024)
- Potential offer soon? (07 Nov 2024)
- AEC Proposal Writer Interview - Help! (07 Nov 2024)
- Internship interview tips (03 Nov 2024)
- Unemployed for a year now, any advice? (30 Oct 2024)
- Interview for Technical Writing Intern (23 Oct 2024)
- Good questions to ask in Document Finishing Job Interview (21 Oct 2024)
- How long are jobs taking to respond to you? (10 Oct 2024)
- Advice for an interview in developer experience? (08 Oct 2024)
- Bad Interview vibes (23 Sep 2024)
- Proposal Writing Interview Tips (22 Sep 2024)
- Trouble job seeking (19 Sep 2024)
- When searching for jobs, in what job category do you search? (11 Sep 2024)
Salaries
Determining whether a salary is fair, asking for a raise, etc.
- Is 45k a typical salary for a full time technical writer at a software company? (Based in Tampa, FL) (30 Dec 2024)
- Should I take a $150 per technical blog writing gig? (26 Dec 2024)
- Making a Case for a Raise (22 Dec 2024)
- Tech Writer Salaries Compared to other in house positions (25 Nov 2024)
- Fair contractor rate for early/mid career US technical writer? (22 Nov 2024)
- government contracting jobs (09 Nov 2024)
- I have two offers and I’d love some input! (07 Nov 2024)
- Compensation thread! Share your salary, RSUs, bonuses, etc. (24 Oct 2024)
- Salary for Senior Technical Writer role in UK (14 Oct 2024)
- Another question about deciding rates (29 Sep 2024)
- Advice for salary negotiations (28 Sep 2024)
- Hourly rate for user guides in 2024? (27 Sep 2024)
- Gender pay gap (26 May 2024)
- Technical writing salary plateau (23 May 2024)
Transitions
Breaking into technical writing from a different field.
General
- Do I have the skills to be a part-time, freelance technical writer? (02 Jan 2025)
- Can I be a tech writer if I'm introverted (21 Dec 2024)
- wanting to start technical writing - where do i start? (17 Dec 2024)
- No Degree but Eager to Start a New Career (15 Nov 2024)
- Technical Writing Early Career Advice (12 Nov 2024)
- Autistic, ADHD, and AuDHD technical writers - tell me about your experiences (11 Nov 2024)
- How social is your role? (25 Aug 2024)
- Career change (02 Aug 2024)
- Getting started in Technical Writing. Looking for entry level job ideas while I pursue training. (29 Jul 2024)
- Landing a job with no experience. (09 Jul 2024)
- How did you become a technical writer? (04 Jun 2024)
- Career advice : Switch into technical writing (29 May 2024)
- Considering a Career in Technical Writing – Seeking Advice! (27 May 2024)
Instructional design
- 3D animated Instructional Designer/Technical Writer with niche experience seeking advice (23 Dec 2024)
- MA in Instructional Design? (21 Sep 2024)
Information technology
- Is It Possible To Be A Technical Writer With 5 Years Of IT Experience, But No Degree? (19 Dec 2024)
- Switching from IT to technical writing (16 Oct 2024)
- What should my next steps be? (15 Jun 2024)
Engineering
- Civil Engineer to Tech Writer (18 Dec 2024)
- Technical Writing in Austin, TX (19 May 2024)
Software developer
- Advice/Resume tips for software engineering dev transitioning to technical writing roles (03 Dec 2024)
- Web Developer looking to transition. How to go about making a resume for TW? (21 Nov 2024)
- Thinking of career change (07 Nov 2024)
- Aspiring DevOps Engineer Switching into Technical Writing. (26 Oct 2024)
- Transition from Software Engineering to UX/UI or Tech Writing (Part-time/Contract Work)? (20 Oct 2024)
Writing
- Best technical writing sectors for creative writers? (18 Nov 2024)
- Does my lack of background in any technical fields put me right out of the running for TW jobs? (16 Nov 2024)
- Proposal Writer (07 Oct 2024)
- Explain to me like I’m 5, please. (27 Sep 2024)
- Transition from Content Writer to Technical writer? (18 Sep 2024)
- Proposal Coordinator to Technical Writer? (11 Sep 2024)
- Any ex-Medical Writers? (26 Jul 2024)
- Transition (21 May 2024)
- Trying to Leave Proposal Writing - Need Advice (13 May 2024)
Technical program manager
Customer support
- Can a person with a tech background but no writing experience get into technical writing? (29 Oct 2024)
- Where/how should I start? (23 Jun 2024)
Journalism
- Square one (or zero, probably) (07 Oct 2024)
- I have a BS in Journalism, interested in technical writing (02 Sep 2024)
- Did any of you transition from traditional journalism? What's the trade-off like? (06 Jun 2024)
Project manager
- Moving into Technical Writing with a tech background (01 Oct 2024)
Teaching
- Quick Questions- Considering getting into this. (11 Sep 2024)
- Jobs? Tell me all about it...is this what I'm looking for? (05 Aug 2024)
- Trying to get into the field (24 Jun 2024)
Teacher
- Transitioning from Education to TW (27 Aug 2024)
- Just Out of College :/ (18 Aug 2024)
Property manager
- PM to TW: Seen it before? (21 Aug 2024)
Animation
- From Animation to Technical Writing? (18 Aug 2024)
Administrative assistant
- Any tech writers here that used to be admin assistants? (17 Aug 2024)
Data analyst
Manufacturing
- New guy looking for some direction (15 Aug 2024)
Product manager
Social media
- Social Media to Technical Writing (01 Jul 2024)
Speech language pathologist
- SLP to technical writer (27 Jun 2024)
- Speech-Language Pathologist to Tech Writer? (05 May 2024)
Advancement
You got the job (congrats). Next steps for growing your TW career.
- Taking step to grow this position in a business. (25 Dec 2024)
- New to technical writing, not sure how to advance at slow job (27 Nov 2024)
- What is your experience as a technical writer and feeling like you aren't doing an adequate job? (22 Oct 2024)
- How long did it take before your first raise/promotion? (22 Oct 2024)
- Is it worth staying in this niche of a Tech Writing role? (09 Oct 2024)
- I need some help - Not sure what seniority level our technical writer is (04 Oct 2024)
- Masters options in tech industry? (13 Sep 2024)
- Freelance tech writers, share your "I wish I had known..." (06 Sep 2024)
- Should I get a Master's degree in Tech Writing? (02 Sep 2024)
- Places to learn (21 Aug 2024)
- Technical Writing Roadmap? (24 Jun 2024)
- Recommendations for keeping myself competitive, when what I do day-to-day might not actually be technical writing? (06 Jun 2024)
- Help on Career Advancement? (01 Jun 2024)
Exits
Leaving technical writing and pursuing another career.
General
- Been doing tech writing remotely for a decade. Currently unemployed. Considering transitioning from tech writing to something semi-related, but would require me to go outside more / use the computer less. Any suggestions? (04 Jan 2025)
- What did you leave Technical Writing for? (30 May 2024)
- What other transferable careers I can get into? Preferably something more stable and safer from layoffs (14 May 2024)
Project management
- It realistic to transition to Project Management? (03 Jan 2025)
Business process manager
Marketing
- Technical Writing to Marketing position (21 Oct 2024)
Teaching
- Transitioning from technical writer to teacher - would a cert be helpful? (20 Oct 2024)
- How to scratch my teaching itch? (20 May 2024)
Product manager
- Technical writer to product manager (13 Sep 2024)
Software developer
- Writer/programmer to developer (12 Sep 2024)
Business analyst
- I have an opportunity to apply for a business analyst-type role at my current company and not sure if I should take it. (19 Aug 2024)
Writing
- Tech Writers that switch to Grant or Proposal Writing (17 Aug 2024)
- Alternate careers? (26 Jul 2024)
- Is a career shift to Proposal writing the best option for me based on my situation? (23 Jul 2024)
- Pivot into Proposal writing (26 Jun 2024)
- Any tech writers who pivoted from tech writing to proposal writing or medical writing? Is the grass greener? (12 May 2024)
Accounting
- Leave tech writing (30 Jul 2024)
Demand
State of the TW job market, what types of TW specialties are in highest demand, which industries pay the most, etc.
- I see alot of job postings for technical writers where I live but hear alot about the career declining? Any thoughts (04 Jan 2025)
- What do you think will happen to technical writing and the job market as we enter 2025? (31 Dec 2024)
- Technical writing/microscopy job market (31 Dec 2024)
- The truth behind contract positions (18 Dec 2024)
- Just landed dream job after 1 year of futile searching (12 Dec 2024)
- Finding contract work. What am I doing wrong or not doing? (07 Dec 2024)
- I'm a sole UK api technical writer how do I get to the USA (27 Nov 2024)
- With AI, what hope do we have? (26 Nov 2024)
- Job Market in Edinburgh, Scotland (23 Nov 2024)
- How's the demand for API docs these days? (14 Nov 2024)
- Digital nomad tech writers (11 Nov 2024)
- Trade union I can join for bid writing? (08 Nov 2024)
- How bad is the job market? (04 Nov 2024)
- Is it worth trying to get into this career? (02 Nov 2024)
- Layoffs hit me - now what? (26 Oct 2024)
- What type of work either volunteer or paid can I do part time after my full-time work for technical writing? (24 Oct 2024)
- Is the TW field volatile? (19 Oct 2024)
- Feeling disillusioned with my job (13 Oct 2024)
- Tangential jobs (10 Oct 2024)
- What industry do you write for? (08 Oct 2024)
- Is this a bad time because of AI? (08 Oct 2024)
- Is technical writing worth it? (08 Oct 2024)
- AI took my job. Now what? (03 Oct 2024)
- What Technical Writing skill are currently the most in demand? (02 Oct 2024)
- Is there any good way to show the value of technical writing in a dollar amount? (26 Sep 2024)
- r/technicalwriting: How are you in the labor market right now? (18 Sep 2024)
r/technicalwriting • u/RobotsAreCoolSaysI • Jun 09 '24
JOB Job Board
This thread is for sharing legitimate technical writing and related job postings and solicitations from recruiters.
r/technicalwriting • u/Contentandcoffee • 2d ago
SEEKING SUPPORT OR ADVICE Vibe-coded AI slop examples
reddit.comr/technicalwriting • u/jhansen123_reddit • 2d ago
Include or omit comma before company form designations such as LLC, LP, Inc., PC, and so forth?
reddit.comr/technicalwriting • u/chimp-chaanakya • 2d ago
JOB Transitioning from SaaS to Aeronautics/Machinery with a BA in English , is a technical degree mandatory?
I have 2 years of experience as a technical writer at a product-based SaaS company, with a MA in English.
I’m looking to pivot into hardware-heavy fields like aeronautics, machinery, or automotive, but almost every job posting lists an engineering or technical degree as a mandatory requirement.
For those in these industries:
- Is a STEM degree a hard filter, or can strong documentation skills and structured authoring (DITA/XML) get me past HR?
- Are there specific standards (like S1000D) or certifications I should learn on my own to bridge the gap?
r/technicalwriting • u/Neko_shii • 3d ago
CAREER ADVICE Is Technical Writing a career path worth pursuing?
Hello! I'm a mid-20s individual struggling to find a career path to pursue. I recently went through a situation where someone I know asked me for help on a project. I happened to have the specific skill they needed, so I took the time to create a road map for them on how to handle these task. After I finished, I sent it to them and never thought of it again.
After they finished their project, they came back to me and said that the road map helped them significantly. They even said (as a joke) that the road map felt like it was holding their hand the entire time because of how much information it provided. Overall, they really appreciated my help and managed to summit their project on time.
After receiving their feedback, I felt pretty good about myself for something I find pretty natural to do.
This situation gave me the inspiration of a possible career path. I did some researching and discovered Technical Writing (TW). TW is definitely up my alley and something that I could potentially strive for.
Of course, I do have my worries about this path. I worry that it's something that AI could easily take over, or that it's an industry that's over saturated.
So if anyone can kindly provide their thoughts and opinions on this matter, I would very much appreciate it.
Edit: Hello everyone! I really appreciate all the responses/advise, and thank you to the people sharing their personal experience. I'm definitely not feeling discouraged, if anything reading all the comments are making me think more of other possibilities. Good thing I only recently started researching on this, so not much time has been wasted
r/technicalwriting • u/BenchPressAddict • 3d ago
Tech writing vs Quality documentation
Reading this subreddit is making me pessimistic about learning technical writing. I'm about the graduate from a material science/chemistry bachelor and I want to learn a skill to work remotely.
How would quality documentation of work instructions, document control, declarations and measurement reports fare in comparison with standard technical writing? Or is this also a branch that is dying out? If you have any experience in this branche I'd love to hear about it.
r/technicalwriting • u/Two_wheels_2112 • 3d ago
SEEKING SUPPORT OR ADVICE TW contractors: errors and omissions insurance?
I'm doing some TW work on contract for the manufacturing company I recently retired from. It's a short-term gig to get InDesign-based docs into DITA.
Their products are safety-critical and lawsuits do occasionally happen. Rarely because of anything in the technical documentation (it usually gets them out of trouble) but it's not impossible to imagine a scenario where an error in assembly or operating instructions could result in property damage, injury, or worse.
I'm going to request an indemnification clause that would say that my work product is subject to technical and compliance review and approval, and therefore the company is responsible for any errors. Do you think this is enough, or should I be looking at errors and omissions insurance?
Or is there some other way you deal with this that I'm not thinking of?
r/technicalwriting • u/Sun_of_Land • 3d ago
Looking for a Technical Writer who loves Engineering. Build, Document & Design Real-World Software
reddit.comr/technicalwriting • u/King_Wolf_- • 4d ago
SEEKING SUPPORT OR ADVICE Where to start Writing
Hi everyone, i’m not proficient in english, and I have an engineering job that involves technical writing (Basically describing what has happened in the analysis. This report includes the usual which are introduction, results, summary etc. Results sometimes composes of table datas, but most of the time discribing a specific phenomenon)
Similar to a technical research maybe
What books do you recommend that teaches this in a very easy and understandable way? All books i have related to grammar the examples are mostly for conversations
THANK YOU
r/technicalwriting • u/Immediate-Homework55 • 4d ago
RESOURCE I've been building a Mac app that turns a screen recording into a step-by-step guide. Would love feedback
Hey everyone!
Lately I've been working on Steppr – https://getsteppr.com
You do a task once and talk through it. Steppr captures a screenshot for every click, highlights it, and transcribes each step from your narration. You can edit and annotate screenshots with arrows and boxes, blur screenshots, and export to PDF, HTML, video, or Markdown.
It's Mac-only. No account, no cloud, no subscription. 7-day free trial, then $9.99 one-time payment.
Note: it isn't notarized yet. If macOS blocks it, go to System Settings > Privacy & Security > "Open Anyway".
I'd appreciate your feedback on what feels clunky or missing, and other use cases you might have for Steppr. Thank you!
r/technicalwriting • u/screamingurethras • 4d ago
QUESTION Any madcap users also integrating AI?
Working in a government space. We have been using Madcap Flare for years and it’s hugely beneficial to our workflows. However, our company recently acquired a version of Claude that we can use with our government work.
My manager is constantly pushing for AI use and wanting to see more. I am doing what I can but it is not enough for him. We can use it for minor things - peer reviews, acronyms, initial draft for new processes, etc. but I’m a bit at a loss how we are supposed to use in a more impactful way that management wants to see. Our most tedious processes are trying to get SME input and I don’t really see AI introducing a way around that. Using the AI option within flare is also not an option for security reasons.
Has anyone else found ways to incorporate AI into their madcap workflows? Or honestly - how are people using it in general? I imagine it will help with draft creation but flare is already a big portion of that and the database of content we keep there is not replaceable/replicable through AI. And if you have found huge time savings - was your goal also to just get more work coming your way to make up the time? This is giving me such anxiety, I’m trying to be proactive. Thank you!
r/technicalwriting • u/noiseknowledge • 5d ago
Portfolio Review
Hi everyone,
I am looking to get my portfolio reviewed. I tried asking Write the Docs on Slack, but no one replied to my request so I eventually deleted my comment.
Is there anyone here who could look at my portfolio and give me some tough feedback?
Thank you.
r/technicalwriting • u/Jazzlike_Page508 • 5d ago
QUESTION How to become a technical writer with out necessary experience in todays climate?
Hiyoo
So I have a bachelors in communication, masters in public administration, and I am currently earning my ABA paralegal cert from Villanova
But I’m curious on how to become a technical writer? I went on indeed and I saw that pretty much all of the job postings leaned heavily on STEM field but scouring through this subreddit I found that pretty much anyone can become one.
Where would I look to find entry level jobs? I recently went on Google and found several websites and I went through the process only to find that there was a paywall to advance any further.
So I’m stuck in between a rock and a hard place. How does one become a technical writer? How can I become an entry level technical writer as I have no experience, and what are some good websites to look at job postings?
Bonus: what necessary skills do you think I’ll need? Remember since I’d be entry level I’m just going in with what I have but I’m not sure it’s anything relating to the field
r/technicalwriting • u/filip_gl • 6d ago
How do you keep your how-to docs and SOPs from going stale?
Where do your processes live (a wiki, Confluence, Google Docs, videos)? Who's responsible for them, and what happens when the software changes and half the screenshots are suddenly stale or plain wrong? Does somebody fix them, or does everyone just ask in Teams or Slack when they're stuck or find something that's clearly outdated.
I'm building something, or rather have built something in this space so I'm quite biased and going solely from my own experience or past struggles, but I'd rather hear how it actually goes for you folks than guess. Or I suppose I'd want to know what your pain points are and what would make this process easier for you.
r/technicalwriting • u/InternationalGap3698 • 8d ago
Is "80% of the way to ASD-STE100" a useful target for cleaning up AI-written docs?
Andrej Karpathy suggested asking LLMs to write "80% of the way to ASD-STE100" to get clearer output. I wanted to see how far that idea goes, so I built a small open-source skill for AI coding tools (Claude Code, Codex, Cursor) that rewrites text in two passes:
- Remove common AI tells (based on Wikipedia's "Signs of AI writing")
- Rewrite in an STE-inspired style: short sentences, one idea per sentence, active voice, no filler
It does **not** enforce the full STE dictionary or the approved-word list. That's the "80%" part.
**Before:** "Great question! Kubernetes liveness probes are a powerful mechanism that enables the kubelet to determine whether a container is healthy — and it's not just a health check, it's your first line of defense…"
**After:** "A liveness probe tells the kubelet if a container is healthy. If the probe fails, the kubelet restarts the container."
My questions for people who actually work with STE or controlled language:
- Which STE rules matter most for readability outside aerospace?
- Which rules would you drop for software docs?
- Is "partial STE" useful, or does it miss the point?
Repo (MIT) if you want to look at the rules I used: [Dodaios/ste80-humanizer](https://github.com/Dodaios/ste80-humanizer)
r/technicalwriting • u/Key-Prompt7936 • 10d ago
QUESTION Technical Writing meetups in SF next week
Does anyone know of any meetups or technical writing events in SF next week?
I have never been to San Francisco before, and I am planning my first trip next week.
I am planning to go there on vacation after months of job hunting (220+ applications) and also check out the WtD meetup.
But are there any other technical writing (or adjacent events) I could go to meet fellow technical writers?
r/technicalwriting • u/WontArnett • 10d ago
POLL Just for fun, let’s do a poll!
Are you an experienced technical writer that’s currently employed?
Or are you currently unable to leverage that experience into an employment situation?
Let’s see how everyone is doing in this lovely job market!
r/technicalwriting • u/ChairmanMrrow • 11d ago
QUESTION Technical writing beyond software
How many members of this sub work on something other than software?
ETA- Most of my experience has been in tools, fasteners, and pumps.
ETA- Writing manuals was my favorite part of my last job.
Edit 11/13: I appreciate the responses. It's interesting to learn about all the different kinds of technical writing one can do.
r/technicalwriting • u/marchenland • 11d ago
QUESTION Images with callouts
I want to pick your brains about images / screenshots.
Do you use them? Do you use callouts such as circled sections, numbers, and lines? What programs do you use to create them? Do you maintain source files or do you make new ones every time? How do you handle consistency such as making sure that all your lines have the same line weight and numbers / letters use the same size font? Do you have any other issues or solutions for improving workflow for maintaining these things? If you could design a tool to improve your experiences with images, what would it do?
r/technicalwriting • u/Superb-Bluebird4648 • 12d ago
Holy Heck is Paligo's Nexus Bad
So, my manager has decided to explore Paligo's Nexus tool. And as bad as their UI and workflow are for normal publication flows, this thing has managed to accomplish something I would have thought impossible: it's somehow worse.
The first problem is their theme tool. It's supposed to be a VS Code plugin that claims "For an edit loop without uploading, the Paligo Theme Studio extension for VS Code renders a theme folder against a real publication as you save." Except that description bears almost no resemblance to what it actually does.
Paligo hands you a folder full of Twig, CSS, and JS, then tells you it’s a “theme” as if you’re building a normal front-end app. In reality, you’re packaging a server-rendered publication template, uploading it to their platform, and then waiting for their backend to reassemble the whole docs site with your design bolted on. It’s not “live preview” in any meaningful sense. It's a long, fragile chain of packaging, uploading, and rendering. That's not a theme. It’s a hostage note to a render pipeline.
And the “customization” isn't a theme layer either. It's a late-stage JS patch job: the page is rendered by the platform, then the client-side script injects the branded content, images, and structure at runtime. The “customized” experience is not actually the template: it's an assembly that occurs in the browser after the fact. What's really happening is that they're shoveling brand assets, nav chrome, and layout bits in via JavaScript when a page loads. Their marketing text is an overly elegant way to describe a system that is, under the hood, rendering a shell and then layering the “real” design on top with script, like too much makeup trying to cover the ugly underneath.
Each render takes over three minutes (yes, I timed it) so if you want to tweak an element and see what changed, that's a three-minute wait... each time. Color not quite right? Three minutes before you can see if your change worked. Font size a little too small? Three minutes before it renders with new headings. Logo cropped funny? Three minutes before you can see if your edit fixed it. Every time, the platform has to repackage the bundle, upload it, validate it, and re-render the publication on the server before you can even see whether a change did anything useful. That is not “live editing.” My smallish sample taking three minutes is a reminder that what's really happening with every edit is a server-side deployment with a side of disappointment.
r/technicalwriting • u/Consistent-Branch-55 • 14d ago
Dear vendors
I can say that the way you act in this sub has turned me off of at least 3-4 of you. I don't think we need some kind of moderation, but you guys really need to think more carefully about engaging here. With love, someone who has considered vendors in the past and will consider vendors again.
r/technicalwriting • u/Loose_Blackberry1146 • 13d ago
College Undergrad Looking to Freelance
So I'm an undergrad in Electronics and Communication Engineering. I am a beginner at most things. I've only got C fundamentals for now and I'm trying to learn Linux and further get into robotics. But I have some writing experience(nothing professional and nothing specifically tech-related). I wanna pursue freelance tech writing as an immediate professional goal but I have no idea what to do for now. Where should I even look for it? How to build a profile, proof of work? And how to get monetised?
P. S. I'm open to online, remote work, preferably from established dev platforms.