TSDoc コメント ガイドライン

タグの詳細・構文・使用例は tags/<tag-name>.md を参照。

必須ルール

• TSDoc 形式（/** ... */）のみ使用する（// や /* */ は TSDoc として認識されない）
• TypeDoc がサポートするタグのみ使用する（独自タグは禁止）
• 説明文は日本語で記述する
• @param の説明にはハイフン区切りを使用する: @param name - 説明
• @param には型を記述しない（TypeScript の型情報から自動推論される）
• 1 行目は概要（summary）— 簡潔に 1 文で記述する
• 詳細説明が必要な場合は空行を挟んで @remarks を使用する
• コンポーネントの Props interface には @param ではなくプロパティごとに TSDoc を記述する
• export default のコンポーネントにはコンポーネント定義の直前に TSDoc を記述する
• named export（型、定数、ユーティリティ）には各 export の直前に TSDoc を記述する

使用可能なタグ