Markdown Editor

技術ドキュメントキット

製品ドキュメントの計画と執筆:ドキュメント計画、スタイルガイド、Diataxisのチュートリアル・ハウツー・リファレンス、各種ガイド。

ステップ 1

計画

  1. Documentation Plan Template

    標準

    Docs plan – audiences and tasks, deliverables inventory, IA, style, pipeline, review, localisation, accessibility, metrics

  2. Technical Writing Style Guide Template

    標準

    Tech writing style guide – voice, grammar do/don't, terminology, UI and code conventions, procedures, inclusive language

ステップ 2

学習

  1. Quickstart Guide Template

    標準

    Quickstart – zero to first success, verifiable steps

    Diataxis (tutorial)
  2. Tutorial Template (Diataxis)

    標準

    Diátaxis tutorial – learning goals, prerequisites, numbered lessons with visible results, checkpoints, troubleshooting

    Diátaxis
  3. How-To Guide Template (Diataxis)

    標準

    How-to guide (Diataxis) – goal-first recipe

    Diataxis (how-to)
  4. Explanation Document Template (Diataxis)

    標準

    Explanation (Diataxis) – why, trade-offs, limits

    Diataxis (explanation)
ステップ 3

参照設計

  1. Reference Documentation Template (Diataxis)

    標準

    Diátaxis reference page – neutral, consistently structured entries for functions, types, errors and constants

    Diátaxis
  2. API Overview and Getting Started Template

    標準

    API landing page – what it does, base URLs, auth in 3 steps, first request, key resources, errors, limits, next steps

  3. CLI Reference Template (Man Page Sections)

    標準

    Command-line reference in man-page order – synopsis, options, commands, environment, files, exit status, examples

  4. Configuration Reference Template

    標準

    Settings reference – precedence rules, file format, per-key type/default/range/env var/since, deprecations, validation

ステップ 4

ガイド

  1. User Manual Template (ISO/IEC/IEEE 26514)

    フル

    Full user manual per ISO/IEC/IEEE 26514 – conventions, notices, concepts, task procedures, reference, errors, accessibility

    ISO/IEC/IEEE 26514:2022
  2. Installation and Configuration Guide Template (ISO/IEC/IEEE 26514)

    フル

    Install guide – requirements, checklist, per-platform steps, verification, config parameters, upgrade, uninstall, hardening

    ISO/IEC/IEEE 26514:2022
  3. Administrator Guide Template (ISO/IEC/IEEE 26514)

    フル

    Admin guide – roles, architecture, access, backup/restore, monitoring, maintenance, scaling, security ops, DR, audit

    ISO/IEC/IEEE 26514:2022
  4. Developer and SDK Guide Template

    フル

    Developer guide – setup, auth, multi-language quick start, errors, pagination, rate limits, webhooks, sandbox, versioning

  5. Migration Guide Template

    標準

    Upgrade/migration guide – who is affected, breaking changes table, timeline, checklist, steps, before/after code, rollback

  6. Troubleshooting Guide Template

    標準

    Symptom/cause/fix index + known issues

ステップ 5

プロジェクトファイル

  1. README Template

    標準

    Lean project README – badges, config table, mermaid

  2. Changelog Template (Keep a Changelog)

    標準

    Keep a Changelog + SemVer

    Keep a Changelog
  3. Release Notes Template

    標準

    Release notes: highlights, features, fixes, breaking changes with migration, deprecations, CVE fixes, upgrade steps