documentation-templates

name	documentation-templates
description	Documentation templates and structure guidelines. README, API docs, code comments, and AI-friendly documentation.
type	skill
created	2026-02-27T00:00:00.000Z
domain	communication-content
category	documentation
risk	safe
source	community
tags	["skill","communication-content","documentation","templates"]

Documentation Templates

Templates and structure guidelines for common documentation types.

---

1. README Structure

Essential Sections (Priority Order)

Section	Purpose
Title + One-liner	What is this?
Quick Start	Running in <5 min
Features	What can I do?
Configuration	How to customize
API Reference	Link to detailed docs
Contributing	How to help
License	Legal

README Template

# Project Name

Brief one-line description.

## Quick Start

[Minimum steps to run]

## Features

- Feature 1
- Feature 2

## Configuration

| Variable | Description | Default |
|----------|-------------|---------|
| PORT | Server port | 3000 |

## Documentation

- API Reference
- Architecture

## License

MIT

---

2. API Documentation Structure

Per-Endpoint Template

## GET /users/:id

Get a user by ID.

**Parameters:**
| Name | Type | Required | Description |
|------|------|----------|-------------|
| id | string | Yes | User ID |

**Response:**
- 200: User object
- 404: User not found

**Example:**
[Request and response example]

---

3. Code Comment Guidelines

JSDoc/TSDoc Template

/**
 * Brief description of what the function does.
 * 
 * @param paramName - Description of parameter
 *  Description of return value
 *   - When this error occurs
 * 
 * 
 * const result = functionName(input);
 */