[@layout]: ./docs.layout.md

# Documentation vocabulary

File types tell you what to expect from a page. This Map gives those types a
shared label, icon, and color throughout the site.

Each definition combines an explanation with its configuration and a rendered
preview. The site root links to this Map to activate it.

---

# Guide

Step-by-step instructions for completing a task.

```yaml
type: guide
icon: route
color: blue
```

---

# Reference

The syntax, options, and behavior of a feature.

```yaml
type: reference
icon: clipboard-list
color: violet
```

---

# Example

A working example to explore and learn from.

```yaml
type: demo
icon: flask-conical
color: emerald
```

---

# Page

An overview or explanation that connects the material.

```yaml
type: page
icon: file-text
color: slate
```