The skills and keywords a Technical Writer resume actually needs in 2026, ranked by demand, mapped to seniority, and shown in real bullet points. Built by a former Google recruiter from 12 years of screening technical writer resumes.
Authored by
Emmanuel Gendre
Tech Resume Writer
Last updated: June 2nd, 2026 · 2,500 words · ~10 min read
The Technical Writer resume skills and keywords that matter in 2026
Technical Writer screens on shipped docs first, then on code-side credibility
Technical Writer is the writing-first specialist on the Docs team. You own developer-facing
documentation content (API references, guides, tutorials, release notes, conceptual docs), you
run the snippets to confirm they work, you file PRs in Markdown or MDX to fix broken examples,
you reconcile the OpenAPI spec with what the docs actually say, and you carry the voice and
style governance that keeps a 400-page site sounding like one product. The seat overlaps with
Docs Engineer on one side (they own the site generator, search, CI, build tooling; you author
inside it) and Developer Advocate on the other (community and stage; you focus on docs that
scale 1:many in writing), sits next to DevRel Engineer (SDK code and sample apps, not docs
content), and shows up under any of those names depending on the vendor. The week looks like
an API reference revision on Monday, a tutorial walkthrough on Tuesday, a release note tied
to the engineering diff on Wednesday, a Vale lint pass on Thursday, and a docs PR review on
Friday. ATS engines score on skills and keywords, and hiring managers on the
other side keep filtering for the same compact set: developer documentation authoring,
Markdown and MDX fluency, docs-as-code in Git, information architecture, voice and style
governance, code-sample verification, audience modeling, and cross-functional partnership with
PM, Eng, and DevRel. What stays unclear is which signals carry the most weight right now,
where 2026 shifted things (Diataxis as the default IA frame, Vale as the default linter, MDX
replacing plain Markdown on most platform vendors, OpenAPI-driven reference generation, docs
deflection rate as the headline outcome metric), and how to phrase the references, guides, and
release notes you actually shipped so both the recruiter and the parser register it.
This page is the cheat sheet
What follows is the ranked rundown of Technical Writer hard skills, soft skills, and ATS
keywords a Senior file wants in 2026, sliced by category and by seniority band, written the way
I would put it on the page after a long stretch reading Stripe, Vercel, MongoDB, HashiCorp,
GitLab, Twilio, and frontier-model vendor Technical Writer resumes. If you want an editable
starter that routes these keywords into the right slots already, grab the
Technical Writer resume template.
Technical Writer resume keywords & skills at a glance
The fast answer, two ways
Most of this page is the deep read on how Technical Writer skills get weighted. When the form is
already open and the deadline is tonight, jump to one of the two tools below: the
industry-standard Technical Writer keyword shortlist (the safe pick when no specific JD is in
hand), or the scanner that lifts the keywords straight out of whichever Technical Writer posting
you happen to be staring at.
Industry-standard Technical Writer resume skills
The 18 keywords that turn up most across Technical Writer postings in
2026. Reach for this list before you have a single JD in hand. Reading the tiers:
blue chips are mandatory, teal chips strengthen the file,
grey chips are the edge that lifts a Senior Technical Writer toward a Staff seat.
1Developer Documentation95%
2API References88%
3Markdown / MDX84%
4Docs-as-Code (Git)76%
5Guides & Tutorials72%
6Release Notes65%
7Information Architecture60%
8Style Guides54%
9Vale / Linters49%
10Diataxis Framework45%
11Code-Sample Verification41%
12Audience Modeling37%
13OpenAPI / Swagger33%
14Cross-Functional Review30%
15Docusaurus / MkDocs26%
16Deflection Rate22%
17Glossary / Terminology19%
18Page-View Lift16%
Extract Technical Writer resume keywords from a JD
Drop a Technical Writer, Documentation Engineer, or Developer
Documentation posting into the box. The scanner picks out the authoring tools, doc formats,
linters, site generators, version-control workflows, and docs metrics worth carrying into your
Skills row and bullets, sorted by tier. Runs locally inside this tab; the JD text never leaves
your machine.
Technical Writer: Hard Skills
8 categories to include in your resume's Technical Skills section
Stars flag the must-haves. The closing line on each card drops straight into the matching row of your
Skills section, no reshaping needed.
Developer Documentation Authoring
The floor every Technical Writer file rests on. API references and guides
carry the must-have row; tutorials and release notes cover the day-to-day plane; conceptual docs
close the row at the Senior band.
The plane Stripe, Vercel, and Mintlify Technical Writer screens cut on.
Markdown carries the must-have row; MDX covers the component-driven docs plane; AsciiDoc and
ReStructuredText close the row on enterprise and Python-heavy stacks.
The signal that splits Technical Writer from a Marketing Writer. Git and
GitHub PRs carry the must-have row; Vale and Markdown linters cover the quality-gate plane;
Spectral and link checkers close the row at the Senior band.
Version control:GitGitHub PR reviewsGitLab MRsQuality gates:ValeMarkdown lintersSpectral (OpenAPI)Link checkers
The row HashiCorp, GitLab, and frontier-model vendor Technical Writer
screens read first. Taxonomy and navigation design carry the must-have row; search-first writing
covers the discoverability plane; content models close the row at the Senior band.
The signal that lifts a Senior Technical Writer toward a Staff seat. Style
guides carry the must-have row; glossaries and terminology management cover the consistency
plane; the Diataxis framework closes the row on platform vendors.
Standards:Style guide ownershipGlossary managementTerminology managementFrameworks:DiataxisMicrosoft Style GuideGoogle Developer StyleVoice and tone audits
Style guide ownership, glossary management, terminology management,
Diataxis, Microsoft Style Guide, Google Developer Style, voice and tone audits
Code Sample Verification
The plane Stripe, Vercel, and frontier-model vendor Technical Writer
screens cut on. Running snippets locally carries the must-have row; filing PRs to fix broken
examples covers the credibility plane; testing against staging closes the row at the Senior
band.
Verification:Run snippets locallyPRs to fix broken examplesStaging test runsTooling:curl / PostmanLocal dev setupOpenAPI reconciliationSnippet test runners
Run snippets locally, PRs to fix broken examples, staging test runs,
curl / Postman, local dev setup, OpenAPI reconciliation, snippet test runners
Audience Modeling
The signal that splits Technical Writer from a Marketing Writer. Persona
docs carry the must-have row; journey-mapped tutorials cover the new-dev onboarding plane;
re-routing flows for the wrong audience close the row at the Senior band.
The plane Stripe, Vercel, and HashiCorp Technical Writer screens read
first when comparing two strong files. PM and Eng review cycles carry the must-have row;
deprecation comms cover the public-API plane; release-note coordination closes the row at the
Senior band.
Soft skills that earn a Technical Writer a callback
Dropping "great communicator" into a Skills row never won a Technical Writer screen. The signal
that lands here sits inside bullets that name the doc, the audience, the publish event, and the
outcome metric. Five rows below, one bullet template per row, ready to adapt to the actual product
and the actual numbers.
Clarity over cleverness
Senior Technical Writer hiring leans on whether you can read a 600-word
first draft, find the 90-word version that actually answers the question, and ship it without
losing the developer who came in halfway through. Quote a moment you cut the page in half and
the page-view or deflection number went up.
How to show it
Cut the Webhooks Overview from 1,400 to 380
words; lifted monthly page views from 3,100 to 9,800, dropped
average time-on-page from 4m 20s to 1m 50s, and cut inbound
"what is a webhook" support tickets by 52 percent.
Audience empathy
The developer reading your tutorial does not have your context. Senior
Technical Writer files show a guide that sits next to the audience it was written for, with
the prerequisites called out and the next step obvious, not a wall of prose written for the
author.
How to show it
Wrote a persona-routed Getting Started flow for
the Python SDK (Backend Web, Data Pipeline, AI Agent); raised first-API-call rate on new
signups from 41 to 67 percent inside 60 days, cut median
time-to-first-call from 22 to 7 minutes.
Patience with ambiguity
A Technical Writer file that reads as "I waited for the spec" loses the
seat. The signal here is that you walked across the office to the engineer building the
feature, read the diff, ran the snippet against staging, and shipped the doc the same day GA
landed.
How to show it
Wrote the v2 Streaming API reference and quickstart
from the engineering diff and a 30-minute review with the EM; shipped on
launch day with the engineering announcement, drove 62 percent of
consumer repos onto v2 inside one quarter.
Judgment on what to cut
A Technical Writer ships against three pulls at once: PM wants every
feature documented, Eng wants every edge case covered, the reader wants 90 words and a code
block. The signal that splits a Senior file from a Mid is you running the trade-off and
shipping the right version.
How to show it
Pulled the 4 edge-case sections out of the v3 OAuth
guide into a separate Advanced OAuth Reference; cut the main guide
from 2,100 to 700 words, lifted first-pass completion on new signups by
31 percent, kept the edge-case content one click away for the 9 percent who
needed it.
Collaboration across Eng, PM, and DevRel
The signal that splits a Senior Technical Writer from one who waits for
tickets. Quote a moment you sat in the RFC review, caught the public-API naming change
before launch, and walked the new term through the glossary, the reference, and the SDK
docs in one sprint.
How to show it
Sat on the v4 Permissions RFC with PM, Eng, and
DevRel; caught the "role" to "principal" rename two weeks before launch,
walked the term through 14 reference pages, 6 guides, and the glossary in
one sprint, shipped clean on launch day with zero post-GA "what does principal mean" inbound.
ATS keywords
How ATS read your resume keywords
What ATS engines do with a Technical Writer resume, how to lift the right authoring tools, doc
formats, linters, site generators, version-control workflows, and docs metrics out of any
Technical Writer JD, and the 25 keywords every Technical Writer resume should carry in 2026.
01
What ATS actually does
The current ATS stack (Workday, Greenhouse, iCIMS, Lever,
SmartRecruiters) reads your resume into structured fields and ranks every candidate against a
keyword set the recruiter or docs hiring manager set on the req. Nobody is auto-rejected by a
machine; you sort lower on a ranked list. For a Technical Writer pipeline that screens hard
on developer documentation authoring, Markdown and MDX, Git workflow, IA, style governance,
and code-sample verification, a lower sort is the same as never being seen.
02
Why position matters
Plenty of ATS engines score where a keyword appears, not just how
often. The same tool name weighs more in the resume title, the Profile Summary, and the
Technical Skills row than it does buried in a hobbies footer. For Technical Writer JDs, the
priority tokens (API references, Markdown, MDX, Git, Vale, OpenAPI, Diataxis, release notes,
style guide, information architecture) belong in the top third of page one, not down in a
closing block.
03
Repetition vs. stuffing
Naming Markdown in the Skills row plus the same word inside two or
three shipped guide bullets is exactly the pattern parsers expect. Pasting it twelve times in
a hidden white-text footer is stuffing and current parsers catch it. The healthy band is 2 to
5 honest occurrences per priority keyword.
Mining your target JD
A 3-step keyword extraction loop
STEP 01
Pull six Technical Writer postings
Grab six Technical Writer, Developer Documentation Writer, or Senior
Docs Writer postings at the company tier you are chasing next (Stripe, Vercel, MongoDB,
HashiCorp, GitLab, Twilio, Supabase, frontier-model vendor, developer-tools startup). Drop
them into one document so the recurring authoring, format, linter, site-generator, Git, and
docs-metric tokens jump out side by side.
STEP 02
Cluster the docs nouns
Mark every doc format, authoring tool, linter, site generator, Git
workflow, and docs metric that recurs in four or more of the six JDs. That cluster is your
priority set. Anything that shows up in only one posting drops to the secondary "include if
true" list.
STEP 03
Reconcile against your resume
Every priority noun should sit in your Skills block AND in at least
one shipped reference, guide, tutorial, release note, or docs-as-code PR bullet. Gaps are
either truthful additions (drop them in where they really belong) or a sign the posting is
wrong for your current Technical Writer band.
The 25 keywords that matter
Technical Writer ATS Keywords ranked by importance, 2026
Frequency reflects appearance across ~220 US Technical Writer postings I read in Q1 and Q2
2026. Tier reflects how hard a recruiter or hiring manager filters on each token.
Keyword
Tier
Typical JD context
JD frequency
Developer Documentation
Must
Docs ownership on every Technical Writer JD
API References
Must
Reference authoring on most Technical Writer JDs
Markdown / MDX
Must
Primary doc format on every JD
Docs-as-Code (Git)
Must
Git-based workflow on Mid and above
Guides & Tutorials
Must
Long-form authoring on Senior JDs
Release Notes
Must
Release-aligned authoring on Mid and above
Information Architecture
Strong
Taxonomy and navigation on every Senior JD
Style Guide Ownership
Strong
Voice governance on Senior Technical Writer files
Vale / Linters
Strong
Automated quality gates on platform-vendor JDs
Diataxis Framework
Strong
IA frame on Senior Technical Writer JDs
Code-Sample Verification
Strong
Credibility plane on developer-docs JDs
Audience Modeling
Strong
Persona docs on Mid and above
OpenAPI / Swagger
Strong
Reference generation on API-vendor JDs
Cross-Functional Review
Strong
PM and Eng review cycles on Senior files
Docusaurus / MkDocs
Bonus
Static-site generator familiarity on platform JDs
Deflection Rate
Bonus
Docs-to-support outcome on Senior files
Glossary / Terminology
Bonus
Consistency program on Staff files
Page-View Lift
Bonus
Content outcome on Senior Technical Writer files
Mintlify / Nextra
Bonus
Modern docs platforms on startup JDs
Spectral (OpenAPI lint)
Bonus
API contract gate on infra-vendor JDs
Link Checkers
Bonus
CI quality gates on Staff files
Conceptual Docs
Bonus
Mental-model writing on platform-vendor JDs
Deprecation Comms
Bonus
Public-API hygiene on Staff Technical Writer files
AsciiDoc / RST
Bonus
Enterprise and Python-stack docs on legacy JDs
Onboarding Flows
Bonus
Activation docs on Senior files
I read your Technical Writer resume, free
Send the PDF over. I will tell you which API reference, guide, tutorial, release-note, and
docs-as-code terms the parser is missing, which bullets read like generic content writing,
and where the developer-docs story falls short of the Senior Technical Writer band.
No charge, returned within 12 hours, by a former Google recruiter who has read a
long run of Stripe, Vercel, MongoDB, HashiCorp, GitLab, Twilio, and frontier-model vendor
Technical Writer resumes.
What Junior, Mid, Senior, and Staff Technical Writers are expected to list
The vocabulary stays roughly steady up the Technical Writer ladder; what shifts is the docs
surface you own, the publish cadence you carry, the IA changes you steward, the cross-functional
partnership scope, and how much your writing moves docs deflection and activation numbers.
Technical Writer has more Junior entry points than DevRel Engineer or Docs Engineer; you can
break in from journalism, comms, support engineering, or an English-plus-Markdown self-taught
path, and the ladder still rewards a strong portfolio over a CS degree.
L1 · ENTRY
Junior Technical Writer
0 to 2 years. Real entry door, with the widest set of background paths
on the Docs team (journalism, English, comms, CS new-grad pivot, support engineer crossover,
in-product UX writer moving up the stack). Draft reference pages and short guides with a Senior
in the room, file Markdown PRs that get reviewed line by line, sit in on PM and Eng review
cycles as note-taker, run Vale locally before pushing, write your first release notes from the
engineering diff, own the glossary on a small product area.
2 to 5 years. Own a slice of the docs surface (one product area or two
SDK language references), ship and maintain 6 to 10 guides and tutorials, run release-aligned
publish cadence on your slice, file PRs to fix broken snippets, sit on PM and Eng review cycles
as the writing lead, partner with DevRel on launch-day docs, run Vale and link checkers as part
of your own PR flow.
5 to 9 years. Own the docs program for a product area end to end,
steward 25 to 60 reference pages plus the guide and tutorial set, drive the IA refresh and the
Diataxis adoption, own the style guide and the glossary, sit on RFCs ahead of GA, drive
release-note coordination across PM, Eng, and DevRel, carry page-view lift and docs deflection
as the headline metrics.
Docs program (product area)Reference set (25 to 60)IA refresh (own)Style guide ownerDiataxis adoptionRFC readingRelease-note coordinationDeflection metric (own)Page-view lift (own metric)
L4 · STAFF / PRINCIPAL
Staff / Principal Technical Writer
9+ years. Set the docs pattern across the product line, steward the
site-wide style guide and glossary, own the cross-product IA program, drive the docs forecast
with the Head of Docs and VP of Product, run hiring loops, partner with Eng on roadmap signal
from docs traffic, and carry org-level docs deflection, activation, and publish-cadence
metrics. At this band the Skills row stops telling the story; published reference set, site
traffic lift, deflection track record, IA refactors, and practice-wide influence carry it
instead. A recognised public footprint (a docs site cited as best in class, conference talks
at Write the Docs or API The Docs, a book or long-running blog) reads as the standard spread.
Docs pattern leadSite-wide style guide stewardCross-product IA programDocs forecastRoadmap signal from docsOrg-level deflectionHiring loopsConference talks (docs)Docs authority
Placement & format
How to list these skills on your resume
One Technical Skills block, 6 to 7 labeled rows, sitting directly beneath the Profile Summary.
Each token surfaces again as proof inside the shipped reference, guide, tutorial, release-note,
and docs-as-code bullets underneath.
01
Placement
Set it right after the Profile Summary, before Work Experience,
with your portfolio link, GitHub, and a docs site you shipped in the header next to LinkedIn.
Technical Writer recruiters read top down, and parsers (Workday, Greenhouse, iCIMS, Lever,
SmartRecruiters) lift docs tokens more reliably when the block sits in a clearly labeled
slot on the first half of page one.
02
Format
Use labeled rows, not a comma-soup paragraph. Pick 6 or 7 row
labels (Authoring & Formats, Docs-as-Code, Information Architecture, Style &
Governance, Verification & Tools, Partnership & Process, Outcome Metrics). Hold each
row to one wrap-friendly line of 5 to 9 nouns, and skip nested bullets inside the Skills
block.
03
How many to include
28 to 38 specific authoring tools, doc formats, linters, site
generators, version-control workflows, and IA frameworks in total. Under 22 reads thin for
any Technical Writer seat above Mid; over 45 reads like a feature dump. Every entry should
be a real tool, format, or metric, never a feeling word.
04
Weaving into bullets
Tie every bullet to the doc, the audience, the publish event,
and the outcome metric. The version that clears the recruiter scan and the ATS sort reads
like this:
Weak
Wrote documentation for the API and helped developers
get started.
Strong
Rewrote the OAuth flow guide in MDX with
a persona-routed entry point; lifted monthly page views from 4,200 to 18,400
inside one quarter, cut inbound OAuth support tickets by 38
percent, raised first-API-call rate on new signups from 41 to 67
percent.
Same scope, but the second line carries six recruiter
signals (doc name, format, IA pattern, page-view lift, deflection, activation) and reads
at the Senior band.
Quality checks
Use the casing the docs use. "Markdown" capitalized, "MDX" all caps, "Git" capitalized,
"GitHub" one word with caps, "Vale" capitalized, "OpenAPI" with the caps, "Docusaurus"
capitalized, "MkDocs" mixed-case, "Diataxis" capitalized, "API" all caps, "SDK" all caps,
"PR" all caps, "RFC" all caps, "IA" all caps.
Drop proficiency stickers ("Expert in Markdown") and skip the star ratings. The screen
cannot verify them, and the entries around them lose credibility by association.
Group by purpose (Authoring & Formats, Docs-as-Code, Information Architecture, Style
& Governance, Verification & Tools, Partnership & Process, Outcome Metrics),
not by alphabet. Technical Writer recruiters scan by category.
Every priority tool or metric in the Skills row needs at least one bullet showing it
inside a real reference, guide, tutorial, release note, or docs-as-code PR. The row
signals familiarity; the bullet proves you shipped with it.
Skills in action
Five shipped bullets, with the Technical Writer keywords wired in
A Technical Writer bullet has to do three jobs at once: name the doc, name the audience and
publish event, and name the outcome metric it pushed. The chips under each line spell out the
tokens a recruiter and the ATS parser will register.
01
Rewrote the OAuth flow guide in MDX with a
persona-routed entry point; lifted monthly page views from 4,200 to 18,400 inside
one quarter, cut inbound OAuth support tickets by 38 percent,
raised first-API-call rate on new signups from 41 to 67 percent.
OAuth GuideMDXPage-View LiftDeflection Rate
02
Shipped the v2 Streaming API reference from the
engineering diff and a 30-minute review with the EM; published on launch day across
14 reference pages and 3 quickstart guides, drove 62 percent of
consumer repos onto v2 inside one quarter, zero post-GA "where is the doc" inbound.
API ReferenceRelease-Aligned PublishOpenAPITime-to-Publish
03
Filed 62 PRs across the SDK reference to fix
broken Python, TypeScript, and Go code samples; ran every snippet against staging before
merge, cut median time-to-fix on a broken-example bug report from 9 days to 1
day, dropped reader-reported "this code does not run" issues by 71
percent.
Drove the Diataxis refresh across 180
pages on the developer docs (reference, how-to, tutorial, explanation); set the
sidebar IA, walked the team through the relabel, owned the redirects with the Docs
Engineer, lifted search-first landings by 44 percent and cut "I cannot
find" support tickets by 29 percent.
Owned the release-note program across PM, Eng,
and DevRel; shipped notes the same day as 14 of 14 minor releases over four
quarters, cut median release-to-publish from 3 days to same day, raised
changelog page views 2.4x on launch days.
These turn up week after week on the Technical Writer reviews I run. Each is a quick rewrite
once you catch the pattern.
No code-side credibility
A file that lists 8 guides and 12 reference pages with no Git
history, no Markdown or MDX fluency, no record of running a snippet, and no PR to fix a broken
example reads as a Marketing Writer reaching for a developer-docs label. The pipeline wants
proof you can sit next to an engineer, read the code, and ship a doc the engineer signs off
on.
Fix: Surface at least 3 code-side artifacts (broken-
snippet PRs filed, OpenAPI reconciliations, tutorials tested against staging, release notes
written from the engineering diff). "Filed 62 PRs across the SDK reference to fix broken Python
and TypeScript samples" closes the gap.
Marketing-voice creep
A Technical Writer file that opens with "passionate storyteller" and
closes with "delight users with elegant copy" reads as a misclassified Marketing Writer or
in-product Content Designer. The screen wants the docs voice: short, direct, audience-named,
outcome-tied, with code in it.
Fix: Cut the brand-voice language and lead with the
doc, the audience, and the metric. "Rewrote the OAuth flow guide for Backend Web devs, lifted
page views 4.4x, cut support tickets 38 percent" reads at the Senior band.
No metrics
A Technical Writer file with reference page names but no page-view
lift, guide names but no deflection number, tutorial names but no activation rate reads as
someone who shipped but does not know the numbers. The screen reads that as a Mid file no
matter how many docs are listed.
Fix: Attach an outcome metric to at least 3 of your
top 5 bullets (page-view lift, support deflection rate, first-API-call rate, time-to-publish,
broken-snippet PR throughput). "Cut inbound OAuth support tickets by 38 percent" closes the gap.
Buried Git and PR fluency
A 2026 Technical Writer file that puts "Microsoft Word" and "Google
Docs" in the Skills row and hides Git and GitHub in a footer reads as someone who has not
worked in a docs-as-code shop. Most Senior Technical Writer postings filter hard on Git in the
Skills section.
Fix: Put Git, GitHub PR reviews, Markdown, MDX, and
Vale on the first line of the Skills block, and back it up with a bullet that names a PR
volume or a CI gate you ran. "Filed 240 docs PRs across three repos, reviewed 180 community
PRs on the SDK reference" closes the gap.
No information architecture signal
A Senior Technical Writer file with 40 pages written and no IA work,
no Diataxis adoption, no sidebar reshuffle, and no redirect plan reads as someone who fills
slots inside someone else's site. Staff and Principal screens filter on whether you can
reshape the site, not just author inside it.
Fix: Surface one IA line on every Senior role.
"Drove the Diataxis refresh across 180 pages, lifted search-first landings by 44 percent" reads
at the Senior band.
Confusing Technical Writer with Content Designer, UX Writer, or Marketing Writer
A file that leads with button labels, empty states, and error
messages reads as a Content Designer or UX Writer. A file that leads with campaigns, landing
pages, and brand voice reads as a Marketing Writer. Technical Writer sits in a different lane:
developer-facing docs content (API references, guides, tutorials, release notes), Markdown and
MDX in Git, code samples that have been run, IA you have shaped.
Fix: Lead with the reference-plus-guide-plus-release-note
combo (a published API reference tied to a guide tied to a release-note flow tied to a deflection
metric) and save in-product copy for the Content Designer or UX Writer file, campaigns and
landing pages for the Marketing Writer file.
Not sure if your Skills section is filtering you out?
Send the resume over. I will tell you which Technical Writer keywords are missing, which
are padding, and which bullets are not pulling their weight.
Free, line-by-line feedback within 12 hours, by a former Google recruiter.
Aim for 28 to 38 specific authoring tools, doc formats, linters, static-site generators,
version-control workflows, and IA frameworks grouped into 6 or 7 labeled rows. Under 22
reads thin for any Technical Writer seat above Mid; over 45 reads like a feature dump.
Every line in the Skills row should resurface inside at least one API reference, guide,
tutorial, release note, or docs-as-code PR bullet.
Developer documentation authoring, API references, guides and tutorials, release notes,
Markdown, MDX, docs-as-code in Git, information architecture, style guides, Diataxis,
Vale, code-sample verification, audience modeling, and cross-functional partnership with
PM and Eng are the non-negotiables. Static-site generators (Docusaurus, MkDocs, Nextra,
Mintlify), OpenAPI, GitHub PR reviews, link checkers, glossary management, and deflection
metrics split Senior and Staff files.
Technical Writer (this page) is the writing-first specialist on the Docs team: owns
developer-facing docs content (API references, guides, tutorials, release notes,
conceptual docs), reads code, runs the snippets, files PRs in Markdown and MDX, and works
inside Git. Docs Engineer owns the docs platform itself (static-site generators, search,
CI pipelines, build tooling) and is code-heavy on infrastructure, not on content.
Developer Advocate is community-first (stage, livestream, conference talks), with less
docs scope. DevRel Engineer ships production SDKs and sample apps as the headline output.
Content Designer and UX Writer own in-product copy (button labels, empty states, error
messages), not developer docs. Marketing Writer covers campaigns and landing pages, no
API references. If your week is an API reference revision on Monday, a tutorial
walkthrough on Tuesday, a release note on Wednesday, a Vale lint pass on Thursday, and a
docs PR review on Friday, you are on the right page.
Enough to read the code, run the snippet locally, spot when an example is broken, and
file the PR to fix it. The bar is lower than DevRel Engineer or Docs Engineer (you do not
ship product features or own the docs platform), but a Technical Writer file with zero
Git activity, no Markdown or MDX fluency, and no record of running the code reads as a
Marketing Writer reaching for a developer-docs label. Surface 3 or 4 concrete code-side
artifacts inside your bullets (a broken-snippet PR you opened, an OpenAPI spec you
reconciled with the docs, a tutorial you tested against staging, a release note you wrote
from the diff).
Quote the page-view growth on revised content (rewrote the OAuth flow guide, lifted
monthly page views from 4,200 to 18,400 inside one quarter), the support deflection you
drove (cut inbound support tickets on the billing API by 38 percent after a fresh
quickstart), the release-aligned publish cadence you carried (shipped release notes the
same day as 14 of 14 minor releases), the docs-driven activation lift (raised first-API-call
rate on new signups from 41 to 67 percent after a redesigned getting-started), and the
broken-snippet throughput (filed 62 PRs to fix code examples across the SDK reference).
A line like "Rewrote the OAuth flow guide, lifted monthly page views from 4,200 to 18,400
inside one quarter, cut inbound OAuth support tickets by 38 percent" reads at the Senior
band.
Yes, more than DevRel Engineer or Docs Engineer. Technical Writer has the widest entry
door on the Docs team. Common paths in are a journalism or English background plus a
self-taught Markdown and Git habit, a CS new-grad who pivoted to docs after a tech
internship, a support engineer who started owning the knowledge base, or an in-product
UX writer who moved up the stack into developer docs. Junior seats land at Stripe, Vercel,
MongoDB, HashiCorp, GitLab, Supabase, Twilio, and frontier-model vendors, and they expect
Markdown fluency, Git basics, and one or two writing samples on a real product, not
Staff-level scope. Run the file through an
ATS Checker to confirm the parse.
No. Site ownership is the Docs Engineer plane (Docusaurus, MkDocs, Nextra, Mintlify,
custom Next.js or Astro docs sites, search, CI, versioning, redirects). A Technical
Writer should know enough to author inside the generator, fix a broken sidebar entry,
and read the build error when a PR fails, but the docs platform itself reports to a Docs
Engineer or to a DevRel Engineer wearing that hat. A Technical Writer file that leads
with site-generator migrations and CI work reads as a misclassified Docs Engineer; flip
it so authoring and IA carry the top 70 percent and the platform familiarity sits as a
closing row.
Tier labels and frequency bars come from a sample of roughly 220 US Technical Writer postings I read
on LinkedIn, Indeed, and direct company career pages in Q1 and Q2 of 2026. Numbers shift each quarter;
check your own target JDs before leaning on any single keyword.