All 60 tasks, level by level

The real graded Technical Writing tasks the portal assigns, grouped into three levels.

The portal assigns these Technical Writing tasks. Finish Level 1 before Level 2 and Level 2 before Level 3. Your mentor may mark some tasks as required for the certificate.

Level 1: Foundations (24 tasks)

TaskWhat to do
What technical writers doExplain the technical writer role and the main document types: tutorials, how-to guides, reference and explanations.
Plain EnglishRewrite 5 confusing paragraphs (from manuals or terms pages) in short, clear sentences.
Know your audienceWrite the same instruction for a beginner, a developer and a manager, and explain the differences.
MarkdownWrite a README in Markdown using headings, lists, links, images, tables and code blocks.
Style guide basicsSummarise 15 rules from the Google developer documentation style guide or Microsoft Writing Style Guide.
Step-by-step how-toWrite a how-to guide for installing Git on Windows with numbered steps and screenshots.
Screenshots and imagesTake, crop and annotate screenshots for your guide, with alt text for each.
Edit someone else's writingEdit a classmate's README for clarity, grammar and structure, and list your changes.
GlossaryWrite a glossary of 20 terms for beginners in web development.
Git for writersKeep your docs in a Git repo named techwriting-internship, using branches and pull requests.
Release notesWrite release notes for an imaginary app update with new features, fixes and known issues.
FAQ pageWrite an FAQ with 10 real questions students ask about internships.
Rewrite an error message setRewrite 10 confusing error messages so they explain what happened and what to do.
Command-line docsDocument a CLI tool's commands, flags and examples.
ChangelogWrite a changelog following Keep a Changelog for three versions of a project.
Contributing guideWrite a CONTRIBUTING.md for an open-source project.
Code comments reviewImprove comments and docstrings in a small codebase.
Readability checkCheck five documents with a readability tool and improve their scores.
Inclusive languageReview a document for non-inclusive terms and replace them.
TemplatesCreate templates for a how-to guide, a tutorial and a reference page.
Screenshots style guideWrite rules for screenshots: size, highlighting, sample data and alt text.
Short video guideRecord a 2-minute screen recording with captions for a simple task.
Docs search testSearch for 10 common tasks in a docs site and note which searches fail.
User feedback widgetAdd a 'Was this page helpful?' feedback option to your docs site.

Level 2: Building real features (20 tasks)

TaskWhat to do
API referenceDocument a public REST API endpoint fully: method, URL, parameters, request, response and errors.
OpenAPIWrite or improve an OpenAPI file for a small API and render it with Swagger UI or Redoc.
TutorialWrite a beginner tutorial that ends with a working result (for example a to-do app), and test it with someone new.
Docs as codePublish your docs as a site with MkDocs, Docusaurus or Hugo.
Information architecturePlan the navigation and page structure of a documentation site for a product.
DiagramsDraw an architecture diagram and a flowchart with Mermaid or draw.io and embed them in your docs.
Contribute to open source docsFind a docs issue in an open-source project and submit a pull request to fix it.
Knowledge base articleWrite 3 help-centre articles for a common support problem with clear titles and steps.
Video scriptWrite a script and storyboard for a 2-minute product tutorial video.
Usability test for docsWatch 2 people follow your tutorial, note where they get stuck, and fix those parts.
SDK reference from codeGenerate reference docs from code comments (JSDoc, Sphinx or Javadoc).
Architecture overview for developersWrite an architecture overview of a project for new developers.
Migration guideWrite a migration guide for a breaking change between two versions.
Docs CIAdd link checking and spell checking to your docs in CI.
Versioned docsPublish docs for two versions of a product on your docs site.
Interview an engineerInterview an engineer about a feature and turn the notes into a doc they approve.
Concept explainer with diagramsWrite a conceptual explanation of OAuth or DNS with two diagrams.
Help centre structureOrganise 20 help articles into categories with clear titles.
Writing for Indian languagesTranslate a short guide into an Indian language and note the challenges.
Docs metrics dashboardShow page views, feedback and search terms for your docs in a simple dashboard.

Level 3: Professional work and capstone (16 tasks)

TaskWhat to do
Docs review checklistCreate a checklist for reviewing technical docs (accuracy, clarity, examples, links, accessibility).
SDK quickstartWrite a quickstart for using an SDK or library in two programming languages.
Troubleshooting guideWrite a troubleshooting guide with symptoms, causes and fixes for 8 common errors.
Docs metricsDefine how you would measure documentation quality (search success, feedback, support tickets).
Writing with AI responsiblyUse an AI tool to draft a page, then fact-check and rewrite it. Document what the AI got wrong.
Localisation-ready writingPrepare a guide for translation: simple sentences, no idioms, and a term list.
Real company docsWrite or improve a user guide page for a Training Trains, W3AppDevelopers or DomainHostly feature.
Capstone: documentation portfolioPublish a docs site with a tutorial, how-to guides, API reference and explanation page, plus a portfolio page linking all your work.
Docs strategyWrite a documentation strategy for a startup: audiences, doc types, tools and ownership.
Content auditAudit an existing docs site: outdated pages, gaps and duplicates, with a priority list.
API docs with try-it-nowPublish API docs where readers can make test calls.
Docs for AI assistantsStructure docs (llms.txt, clear headings) so AI tools can answer from them correctly.
Training programCreate a short training for developers on writing good READMEs.
Accessibility audit of docsAudit your docs site for accessibility and fix issues.
Portfolio case studyWrite a case study about one docs project: problem, process and results.
Capstone 2: docs for a real productProduce complete documentation for a real open-source project or a Training Trains/W3/DH feature, reviewed and accepted by its owners.
โ† Tools and first-week setupSubmitting tasks and earning your certificate โ†’