site-com/documentation/add-section.md

---

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

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.

Create the folder. docs/<section-slug>/. Slug kebab-case.

Add the category landing page. docs/<section-slug>/index.md (or _category_.json for advanced control). Recommended:

---
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>.

Add child entries following add-guide.md.

Order the section in the sidebar by giving the folder an _category_.json:

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

Lower position = higher in the sidebar.

Update static/llms.txt. Add a ## <Nome da seção> block listing each child entry's .md URL.

• 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.