# Documentation

> How to update project documentation

- Skill: `fossasia/documentation` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add fossasia/documentation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/fossasia/documentation/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: fossasia (https://skillmd.com/u/fossasia)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/fossasia/documentation

---


# Skill: Documentation

## Documentation Files

| File | Purpose |
|---|---|
| `README.rst` | Project overview and getting-started guide (reStructuredText) |
| `CONTRIBUTING.md` | Contributor guidelines and development setup |
| `DEPLOYMENT.md` | Production deployment walkthrough |
| `.github/instructions/dockerfile.instructions.md` | Docker Compose usage and container reference |
| `doc/` | Extended project documentation |

## How to Update `README.rst`

- Written in **reStructuredText** (`.rst`).
- Keep the getting-started steps current when CLI commands or workflows change.
- Maintain existing section structure; add new sections at a logical location.

## How to Update `doc/`

- Files may be `.rst` or `.md` depending on the sub-section.
- Follow the existing style of the surrounding files.
- Run a documentation build locally if a build pipeline is configured.

## How to Update `CONTRIBUTING.md`

- Keep the setup instructions in sync with `README.rst`.
- Document any new tooling or workflow changes that affect contributors.

## General Guidelines

- Keep documentation concise and accurate.
- Prefer concrete examples over abstract descriptions.
- When changing a CLI command, update all documentation that references it.
- Documentation changes do not require tests unless there are specific doc-tests.