Technical documentation writing

Goal

Write and edit developer-facing documentation that is easy to consume: plain, task-oriented, active-voice prose with scannable structure and clean punctuation. Own the words and their organization within a page.

Not Dev Portal specific, but it pairs with the portal skills: portal-page-design for the components that hold the prose, portal-branding for appearance. Work in page content files, locally or in a repo, and do not push destructive changes to a live portal unless the user explicitly asks.

Clarify First

Ask two or three high-impact questions, each with a default to confirm: