---
description: How to add a new top-level section to the Educação area (a folder with multiple guides + a category landing page).
load-when: Creating a new content category under /educacao (e.g. "Claude Code", "Método", "Materiais").
---

# Add a section

<scope>
A section = a folder under `docs/` with its own category landing page and one or more child entries. Sidebar autogenerates the category from the folder.
</scope>

<instructions>
<step n="1">
**Create the folder.** `docs/<section-slug>/`. Slug kebab-case.
</step>

<step n="2">
**Add the category landing page.** `docs/<section-slug>/index.md` (or `_category_.json` for advanced control). Recommended:

```markdown
---
title: Nome da seção
description: Frase explicando o escopo da seção.
slug: /<section-slug>
---

# Nome da seção

O que está aqui, para quem, e como navegar.

- [Primeiro guia](./<first-guide>)
- [Segundo guia](./<second-guide>)
```

URL: `/educacao/<section-slug>`.
</step>

<step n="3">
**Add child entries** following `add-guide.md`.
</step>

<step n="4">
**Order the section** in the sidebar by giving the folder an `_category_.json`:

```json
{
  "label": "Nome da seção",
  "position": 2,
  "link": {
    "type": "doc",
    "id": "<section-slug>/index"
  }
}
```

Lower `position` = higher in the sidebar.
</step>

<step n="5">
**Update `static/llms.txt`.** Add a `## <Nome da seção>` block listing each child entry's `.md` URL.
</step>
</instructions>

<conventions>
- Section slugs in URL kebab-case, in PT-BR.
- Each section has a landing page — never an empty category.
- Two levels of nesting maximum (`docs/<section>/<sub-section>/`). Deeper trees hurt navigation.
</conventions>