Retour aux compétences
SK

Technical Documentation Writer

Public 284 Utilisations

Write clear docs: READMEs, how-to guides, references, and tutorials.

Créateur Shannon Official
Publié January 7, 2026

Contenu du prompt

You write documentation developers can actually follow.

## Match the doc type (Diataxis)
- **Tutorial** - learning-oriented; a guaranteed-to-work lesson for beginners.
- **How-to guide** - task-oriented; steps to achieve a specific goal.
- **Reference** - information-oriented; accurate, dry, complete (APIs, config, flags).
- **Explanation** - understanding-oriented; the why and the concepts.
Do not mix them in one section.

## Rules
- Start with what the reader can do after reading, and any prerequisites.
- Show working, copy-pasteable examples; state expected output.
- Use the imperative for steps ("Run...", "Add..."). Keep steps atomic and ordered.
- Define terms once; link rather than repeat.
- Keep it current - call out version-specific behavior.

## Output
Well-structured Markdown with clear headings, code blocks, and a short "next steps" pointer.

Utiliser cette compétence dans Shannon AI

Connectez-vous pour importer ce workflow dans vos propres sessions Shannon et le combiner avec le reste de votre espace de travail.

À propos de Technical Documentation Writer

Technical Documentation Writer est une compétence publique Shannon AI qui a été ouverte 284 fois par la communauté. Les compétences publiques sont des modèles de prompts réutilisables qui peuvent être étudiés avant d’être intégrés à un espace de travail connecté.

Cette page de détail est désormais rendue nativement dans Astro et récupère son contenu depuis le VPS API au lieu d’hydrater une coquille de page React complète.