Technical Writer
Creating and maintaining technical documentation: API docs, user guides, knowledge bases, docs-as-code
Technical Writer is a role in the Technical Writing family. It has 45 skills across 5 levels (from Junior to Principal). 50 skills are mandatory. Key domains: Programming Fundamentals, Database Management, API & Integration.
Skill Matrix
45 skills × 5 levels. Click on a cell for details.
AI-Assisted Development
4 skills| Skills | Jun | Mid | Sen | Lead | Princ |
|---|---|---|---|---|---|
| GitHub Copilot | A | W | A | E | E |
| ChatGPT / Claude | A | W | A | E | E |
| Prompt Engineering for Code | A | W | A | E | E |
| AI Documentation Generation | A | W | A | E | E |
API & Integration
7 skills| Skills | Jun | Mid | Sen | Lead | Princ |
|---|---|---|---|---|---|
| REST API Design | A | W | A | E | E |
| GraphQL Design | A | W | A | E | E |
| WebSocket API Design | A | W | A | E | E |
| Server-Sent Events & Streaming | A | W | A | E | E |
| gRPC & Protocol Buffers | A | W | A | E | E |
| API Versioning Strategies | A | W | A | E | E |
| API Documentation | A | W | A | E | E |
Architecture & System Design
5 skills| Skills | Jun | Mid | Sen | Lead | Princ |
|---|---|---|---|---|---|
| System Design Fundamentals | A | W | A | E | E |
| Microservices Decomposition | A | W | A | E | E |
| Hexagonal Architecture | A | W | A | E | E |
| Clean Architecture | A | W | A | E | E |
| Architecture Decision Records (ADR) | A | W | A | E | E |
Cloud & Infrastructure
3 skills| Skills | Jun | Mid | Sen | Lead | Princ |
|---|---|---|---|---|---|
| Docker | A | W | A | E | E |
| Kubernetes Core | A | W | A | E | E |
| AWS | A | W | A | E | E |
Database Management
1 skills| Skills | Jun | Mid | Sen | Lead | Princ |
|---|---|---|---|---|---|
| PostgreSQL | A | W | A | E | E |
DevOps & CI/CD
1 skills| Skills | Jun | Mid | Sen | Lead | Princ |
|---|---|---|---|---|---|
| GitHub Actions / GitLab CI | A | W | A | E | E |
Documentation
8 skills| Skills | Jun | Mid | Sen | Lead | Princ |
|---|---|---|---|---|---|
| API Documentation Writing | A | W | A | E | E |
| Architecture Documentation: C4, arc42 | A | W | A | E | E |
| Runbook & Playbook Writing | A | W | A | E | E |
| User Documentation | A | W | A | E | E |
| Knowledge Base Management | A | W | A | E | E |
| Docs-as-Code: MkDocs, Docusaurus, Antora | A | W | A | E | E |
| Diagramming: Mermaid, PlantUML, D2 | A | W | A | E | E |
| Technical Blogging | A | W | A | E | E |
Observability & Monitoring
2 skills| Skills | Jun | Mid | Sen | Lead | Princ |
|---|---|---|---|---|---|
| Structured Logging | A | W | A | E | E |
| Prometheus & Grafana | A | W | A | E | E |
Programming Fundamentals
6 skills| Skills | Jun | Mid | Sen | Lead | Princ |
|---|---|---|---|---|---|
| Algorithms & Complexity | A | W | A | E | E |
| Data Structures | A | W | A | E | E |
| OOP & SOLID Principles | A | W | A | E | E |
| Design Patterns | A | W | A | E | E |
| Async Programming | A | W | A | E | E |
| Code Quality & Refactoring | A | W | A | E | E |
Security
1 skills| Skills | Jun | Mid | Sen | Lead | Princ |
|---|---|---|---|---|---|
| OWASP & Application Security | A | W | A | E | E |
Testing & QA
2 skills| Skills | Jun | Mid | Sen | Lead | Princ |
|---|---|---|---|---|---|
| Unit Testing | A | W | A | E | E |
| Integration Testing | A | W | A | E | E |
Version Control & Collaboration
5 skills| Skills | Jun | Mid | Sen | Lead | Princ |
|---|---|---|---|---|---|
| Git Advanced | A | W | A | E | E |
| Git LFS | A | W | A | E | E |
| Code Review | A | W | A | E | E |
| Documentation as Code | A | W | A | E | E |
| InnerSource Practices | A | W | A | E | E |
FAQ
What skills are needed for the Technical Writer role?
The Technical Writer role requires 45 skills, of which 50 are mandatory. Skills are distributed across 5 levels: from Junior to Principal. See full matrix.
How to advance to the next level in the Technical Writer role?
Use the Grade Calculator to assess your current level and get personalized recommendations. The system will show which skills need to be developed for the next level.
How does the community define requirements for the Technical Writer role?
Role requirements are shaped by the community through a proposal system. Any member can suggest changes that go through voting and expert review.