Technical Writer & Developer Advocate

Create content and communities that drive developer adoption

10 milestones in this roadmap

Step 1beginner4-6 weeks

Technical Writing Fundamentals

Build the core writing skills that make complex technical concepts accessible, accurate, and actionable for developer audiences.

Curriculum

1Clear writing: active voice, concise sentences, jargon calibration, and readability scoring
2Audience analysis: developer personas, skill level assessment, and context-appropriate depth
3Documentation types: conceptual guides, how-to tutorials, reference docs, and troubleshooting guides
4Style guides: Google Developer Documentation Style Guide, Microsoft Style Guide, and house style creation
5Grammar and mechanics: technical grammar conventions, code-adjacent punctuation, and consistency rules
6Information architecture: content hierarchy, navigation design, progressive disclosure, and content reuse

Tools & Platforms

Google Technical Writing CourseHemingway EditorGrammarlyVale (style linting)

✍️

Step 1beginner4-6 weeks

Technical Writing Fundamentals

Build the core writing skills that make complex technical concepts accessible, accurate, and actionable for developer audiences.

Curriculum

1Clear writing: active voice, concise sentences, jargon calibration, and readability scoring
2Audience analysis: developer personas, skill level assessment, and context-appropriate depth
3Documentation types: conceptual guides, how-to tutorials, reference docs, and troubleshooting guides
4Style guides: Google Developer Documentation Style Guide, Microsoft Style Guide, and house style creation

Step 2beginner3-4 weeks

Documentation Tools & Workflows

Establish professional documentation workflows that treat docs as a first-class engineering deliverable with proper tooling and review processes.

Curriculum

1Markdown mastery: CommonMark spec, GitHub Flavoured Markdown, tables, and cross-references
2MDX: embedding React components in Markdown, interactive examples, and custom components
3Docusaurus: site setup, sidebar configuration, versioned docs, and plugin ecosystem
4GitBook: spaces, variants, integrations, and collaborative editing workflows

Step 3intermediate4-6 weeks

API Documentation

Create API documentation that enables developers to integrate quickly and successfully, reducing support burden and increasing adoption.

Curriculum

1OpenAPI spec documentation: path descriptions, parameter documentation, and schema examples
2Code samples: multi-language examples, copy-paste ready snippets, and SDK quickstarts
3Authentication guides: step-by-step OAuth flows, API key setup, and token management walkthroughs
4Error reference: error code catalog, troubleshooting guides, and common mistake documentation

Step 4intermediate4-6 weeks

Tutorial & Guide Creation

Create tutorials and guides that take developers from zero to working implementation with clear steps, context, and confidence building.

Curriculum

1Learning objectives: measurable outcomes, skill prerequisites, and completion criteria
2Progressive complexity: scaffolded examples, building-block approach, and checkpoint validation
3Code walkthroughs: annotated code blocks, diff-based explanations, and running example repositories
4Troubleshooting sections: common errors, debugging strategies, and FAQ compilation

Step 5intermediate4-6 weeks

Video Content Production

Expand your content toolkit to include video, reaching developers who prefer visual learning and building personal brand through multimedia.

Curriculum

1Screen recording: resolution settings, cursor highlighting, zoom effects, and multi-monitor capture
2Presentation skills: pacing, vocal clarity, energy management, and teleprompter usage
3Video editing: cuts, transitions, lower thirds, chapter markers, and audio normalisation
4YouTube optimisation: thumbnails, titles, descriptions, tags, end screens, and analytics

Step 6intermediate4-6 weeks

Developer Community Building

Create thriving developer communities that drive product adoption, generate feedback, and build lasting relationships with your developer audience.

Curriculum

1Discord/Slack community setup: channel structure, roles, bots, and onboarding workflows
2Forum moderation: community guidelines, conflict resolution, and constructive discussion facilitation
3Community metrics: engagement rates, retention, growth, sentiment analysis, and health scoring
4

Step 7advanced3-4 weeks

Conference Speaking

Build the public speaking skills to represent your product or technology at conferences, meetups, and industry events with confidence and impact.

Curriculum

1CFP writing: compelling abstracts, talk titles, bio crafting, and conference selection strategy
2Slide design: visual hierarchy, code on slides, animation restraint, and accessibility
3Storytelling: narrative arc for technical talks, analogies, and audience engagement techniques
4Live demos: demo environment preparation, backup plans, fallback slides, and pacing

Step 8advanced4-6 weeks

Content Strategy

Move from individual content pieces to a strategic content programme that consistently reaches, engages, and converts developer audiences.

Curriculum

1Editorial calendars: content planning, publication cadence, and cross-channel coordination
2SEO for developers: keyword research, search intent, technical SEO, and developer-specific ranking factors
3Content analytics: page views, time on page, bounce rate, conversion tracking, and content scoring
4Distribution channels: dev.to, Hashnode, Hacker News, Reddit, and syndication strategies

Step 9advanced4-6 weeks

Developer Experience

Champion the developer experience by systematically identifying and removing friction from every touchpoint in the developer journey.

Curriculum

1DX auditing: time-to-hello-world measurement, friction logging, and competitive DX benchmarking
2Onboarding optimisation: signup flow analysis, quickstart effectiveness, and drop-off identification
3SDK design principles: idiomatic language patterns, consistent interfaces, and progressive disclosure
4Error message design: actionable errors, error codes, suggested fixes, and documentation links

Step 10advanced3-4 weeks

DevRel Metrics & Impact

Prove the business impact of developer relations with metrics frameworks that connect community activities to product adoption and revenue.

Curriculum

1Developer adoption funnel: awareness, activation, engagement, retention, and advocacy stages
2Attribution models: multi-touch attribution, content influence tracking, and community-sourced leads
3ROI measurement: cost per developer acquired, lifetime value, and programme cost justification
4Community health metrics: active contributors, response time, sentiment trends, and churn analysis

Ready to start this journey?

Browse our courses and books to begin your learning path.

Browse Courses Browse Books

Grammar and mechanics: technical grammar conventions, code-adjacent punctuation, and consistency rules

6Information architecture: content hierarchy, navigation design, progressive disclosure, and content reuse

Tools & Platforms

Google Technical Writing CourseHemingway EditorGrammarlyVale (style linting)

5Docs-as-code: Git workflows for docs, pull request reviews, and continuous deployment

6Review processes: technical review checklists, editorial review, and freshness audits

Tools & Platforms

Docusaurus / NextraGitBookMarkdown / MDXGitHub (version control)Netlify / Vercel (hosting)

Step 2beginner3-4 weeks

Documentation Tools & Workflows

Establish professional documentation workflows that treat docs as a first-class engineering deliverable with proper tooling and review processes.

Curriculum

1Markdown mastery: CommonMark spec, GitHub Flavoured Markdown, tables, and cross-references
2MDX: embedding React components in Markdown, interactive examples, and custom components
3Docusaurus: site setup, sidebar configuration, versioned docs, and plugin ecosystem
4GitBook: spaces, variants, integrations, and collaborative editing workflows
5Docs-as-code: Git workflows for docs, pull request reviews, and continuous deployment
6Review processes: technical review checklists, editorial review, and freshness audits

Tools & Platforms

Docusaurus / NextraGitBookMarkdown / MDXGitHub (version control)Netlify / Vercel (hosting)

5Postman collections: pre-built request collections, environment variables, and automated testing

6Interactive docs: try-it-now API explorers, sandbox environments, and embedded code playgrounds

Tools & Platforms

Swagger UI / RedocPostmanReadMe.ioMintlifyStoplight

Step 3intermediate4-6 weeks

API Documentation

Create API documentation that enables developers to integrate quickly and successfully, reducing support burden and increasing adoption.

Curriculum

1OpenAPI spec documentation: path descriptions, parameter documentation, and schema examples
2Code samples: multi-language examples, copy-paste ready snippets, and SDK quickstarts
3Authentication guides: step-by-step OAuth flows, API key setup, and token management walkthroughs
4Error reference: error code catalog, troubleshooting guides, and common mistake documentation
5Postman collections: pre-built request collections, environment variables, and automated testing
6Interactive docs: try-it-now API explorers, sandbox environments, and embedded code playgrounds

Tools & Platforms

Swagger UI / RedocPostmanReadMe.ioMintlifyStoplight

5Template design: reusable tutorial structures, consistent formatting, and maintainable content patterns

6Testing tutorials: end-to-end tutorial testing, broken link detection, and code sample validation

Tools & Platforms

GitHub (sample repos)CodeSandbox / StackBlitzJupyter NotebooksLoom (video supplements)

Step 4intermediate4-6 weeks

Tutorial & Guide Creation

Create tutorials and guides that take developers from zero to working implementation with clear steps, context, and confidence building.

Curriculum

1Learning objectives: measurable outcomes, skill prerequisites, and completion criteria
2Progressive complexity: scaffolded examples, building-block approach, and checkpoint validation
3Code walkthroughs: annotated code blocks, diff-based explanations, and running example repositories
4Troubleshooting sections: common errors, debugging strategies, and FAQ compilation
5Template design: reusable tutorial structures, consistent formatting, and maintainable content patterns
6Testing tutorials: end-to-end tutorial testing, broken link detection, and code sample validation

Tools & Platforms

GitHub (sample repos)CodeSandbox / StackBlitzJupyter NotebooksLoom (video supplements)

5Live streaming: OBS setup, scene management, chat interaction, and stream archiving

6Webinar hosting: platform selection, audience engagement, Q&A management, and follow-up content

Tools & Platforms

OBS StudioCamtasia / ScreenFlowDaVinci Resolve / Premiere ProYouTube StudioStreamYard / Restream

Step 5intermediate4-6 weeks

Video Content Production

Expand your content toolkit to include video, reaching developers who prefer visual learning and building personal brand through multimedia.

Curriculum

1Screen recording: resolution settings, cursor highlighting, zoom effects, and multi-monitor capture
2Presentation skills: pacing, vocal clarity, energy management, and teleprompter usage
3Video editing: cuts, transitions, lower thirds, chapter markers, and audio normalisation
4YouTube optimisation: thumbnails, titles, descriptions, tags, end screens, and analytics
5Live streaming: OBS setup, scene management, chat interaction, and stream archiving
6Webinar hosting: platform selection, audience engagement, Q&A management, and follow-up content

Tools & Platforms

OBS StudioCamtasia / ScreenFlowDaVinci Resolve / Premiere ProYouTube StudioStreamYard / Restream

Ambassador programs: selection criteria, benefits, responsibilities, and program management

5Hackathons: event planning, judging criteria, sponsor management, and post-event follow-up

6Community-led content: user-generated tutorials, community showcases, and contribution recognition

Tools & Platforms

Discord / SlackDiscourse / GitHub DiscussionsOrbit / Common RoomLuma / Eventbrite (events)

Step 6intermediate4-6 weeks

Developer Community Building

Create thriving developer communities that drive product adoption, generate feedback, and build lasting relationships with your developer audience.

Curriculum

1Discord/Slack community setup: channel structure, roles, bots, and onboarding workflows
2Forum moderation: community guidelines, conflict resolution, and constructive discussion facilitation
3Community metrics: engagement rates, retention, growth, sentiment analysis, and health scoring
4Ambassador programs: selection criteria, benefits, responsibilities, and program management
5Hackathons: event planning, judging criteria, sponsor management, and post-event follow-up
6Community-led content: user-generated tutorials, community showcases, and contribution recognition

Tools & Platforms

Discord / SlackDiscourse / GitHub DiscussionsOrbit / Common RoomLuma / Eventbrite (events)

5Handling Q&A: difficult question strategies, graceful deferrals, and follow-up commitment

6Speaker portfolio: talk recordings, slide archives, testimonials, and speaking page maintenance

Tools & Platforms

Keynote / Google SlidesExcalidraw (diagrams)Speaker Deck / NotistSessionize (CFP platform)

Step 7advanced3-4 weeks

Conference Speaking

Build the public speaking skills to represent your product or technology at conferences, meetups, and industry events with confidence and impact.

Curriculum

1CFP writing: compelling abstracts, talk titles, bio crafting, and conference selection strategy
2Slide design: visual hierarchy, code on slides, animation restraint, and accessibility
3Storytelling: narrative arc for technical talks, analogies, and audience engagement techniques
4Live demos: demo environment preparation, backup plans, fallback slides, and pacing
5Handling Q&A: difficult question strategies, graceful deferrals, and follow-up commitment
6Speaker portfolio: talk recordings, slide archives, testimonials, and speaking page maintenance

Tools & Platforms

Keynote / Google SlidesExcalidraw (diagrams)Speaker Deck / NotistSessionize (CFP platform)

5Newsletter growth: subscriber acquisition, engagement optimisation, and retention strategies

6Social media: Twitter/X developer community, LinkedIn technical content, and platform-specific strategies

Tools & Platforms

Ahrefs / Semrush (SEO)Substack / ButtondownBuffer / TypefullyGoogle Analytics / Plausible

Step 8advanced4-6 weeks

Content Strategy

Move from individual content pieces to a strategic content programme that consistently reaches, engages, and converts developer audiences.

Curriculum

1Editorial calendars: content planning, publication cadence, and cross-channel coordination
2SEO for developers: keyword research, search intent, technical SEO, and developer-specific ranking factors
3Content analytics: page views, time on page, bounce rate, conversion tracking, and content scoring
4Distribution channels: dev.to, Hashnode, Hacker News, Reddit, and syndication strategies
5Newsletter growth: subscriber acquisition, engagement optimisation, and retention strategies
6Social media: Twitter/X developer community, LinkedIn technical content, and platform-specific strategies

Tools & Platforms

Ahrefs / Semrush (SEO)Substack / ButtondownBuffer / TypefullyGoogle Analytics / Plausible

5Developer journey mapping: awareness to mastery stages, touchpoint analysis, and gap identification

6Feedback collection: developer surveys, NPS for developers, support ticket analysis, and user interviews

Tools & Platforms

FullStory / Hotjar (DX analytics)LaunchDarkly (feature flags)Sentry (error tracking)Intercom / Zendesk

Step 9advanced4-6 weeks

Developer Experience

Champion the developer experience by systematically identifying and removing friction from every touchpoint in the developer journey.

Curriculum

1DX auditing: time-to-hello-world measurement, friction logging, and competitive DX benchmarking
2Onboarding optimisation: signup flow analysis, quickstart effectiveness, and drop-off identification
3SDK design principles: idiomatic language patterns, consistent interfaces, and progressive disclosure
4Error message design: actionable errors, error codes, suggested fixes, and documentation links
5Developer journey mapping: awareness to mastery stages, touchpoint analysis, and gap identification
6Feedback collection: developer surveys, NPS for developers, support ticket analysis, and user interviews

Tools & Platforms

FullStory / Hotjar (DX analytics)LaunchDarkly (feature flags)Sentry (error tracking)Intercom / Zendesk

5Feedback loops: structured feedback channels to product teams, feature request tracking, and prioritisation

6Reporting frameworks: executive dashboards, quarterly business reviews, and impact storytelling

Tools & Platforms

Orbit / Common RoomAmplitude / MixpanelLooker / Metabase (dashboards)Notion / Confluence (reporting)

Step 10advanced3-4 weeks

DevRel Metrics & Impact

Prove the business impact of developer relations with metrics frameworks that connect community activities to product adoption and revenue.

Curriculum

1Developer adoption funnel: awareness, activation, engagement, retention, and advocacy stages
2Attribution models: multi-touch attribution, content influence tracking, and community-sourced leads
3ROI measurement: cost per developer acquired, lifetime value, and programme cost justification
4Community health metrics: active contributors, response time, sentiment trends, and churn analysis
5Feedback loops: structured feedback channels to product teams, feature request tracking, and prioritisation
6Reporting frameworks: executive dashboards, quarterly business reviews, and impact storytelling

Tools & Platforms

Orbit / Common RoomAmplitude / MixpanelLooker / Metabase (dashboards)Notion / Confluence (reporting)