# Slang Docs

> Read and write Slang compiler documentation.

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

---


## From project

Drawn from: `repos/slang/CLAUDE.md` (documentation sections), `repos/slang/.claude/agents/documentation-accuracy-reviewer.md` (doc drift detection, stale comments, proposal status tracking).

## Documentation locations

- `docs/user-guide/` -- User-facing documentation (published at shader-slang.com/slang/user-guide/)
- `docs/design/` -- Design decisions, coding conventions
- `docs/building.md` -- Build instructions
- `docs/diagnostics.md` -- Diagnostic test documentation
- `include/slang.h` -- API documentation (inline comments, ABI-critical)
- `prelude/` and `*.meta.slang` -- Standard library docs via `@param`, `@remarks`, `@return`, `@example` annotations
- `external/spec/` -- Language specification and proposals (clone from `https://github.com/shader-slang/spec.git`)

## Doc style

### API docs (include/slang.h)

Comments must match actual behavior. For experimental interfaces, mark with `_Experimental`. New virtual methods only at end of interfaces.

### Standard library (*.meta.slang)

```slang
/// Description of the function.
/// @param x First parameter.
/// @return The result.
__generic<T : __BuiltinArithmeticType>
T myFunc(T x);
```

### User guide (docs/user-guide/)

After modifying user guide pages, regenerate the table of contents:

```bash
cd docs && powershell ./build_toc.ps1
# Or use /regenerate-toc bot command on the PR
```

## Doc accuracy checklist (from project agents)

When reviewing or writing docs:

- Check stale inline comments near changed code that reference old variable names or removed logic.
- Verify `include/slang.h` function comments match the current implementation.
- If a PR implements a spec proposal from `external/spec/proposals/`, update its status to `Implemented`.
- Check feature maturity tables in `docs/` if the change affects a support matrix.
- Notable user-facing changes should appear in the CHANGELOG.

## Output format

- Docs go in the location matching their type (user guide, API inline, design doc — see locations above)
- User guide pages: Markdown with Vitepress front matter; run `powershell ./build_toc.ps1` to regenerate TOC after adding/renaming pages
- API comments (`include/slang.h`): C-style `/** ... */` with `@param`/`@return`/`@remarks` tags
- Standard library (`.meta.slang`): `/// ... @param @return` triple-slash style
- Do not add conversational filler or TODOs to committed docs — write finished text

## Documenting new diagnostics

When introducing new warnings/errors, update:
- `docs/language-reference/` -- Language features and restrictions
- `docs/user-guide/` -- User-facing guidance
- `docs/design/` -- Design rationale