---
description: How to add a chronological article inside the Educação section. Blog plugin is disabled — articles live as docs entries with a date in frontmatter.
load-when: Publishing a dated article (e.g. an essay or analysis piece) on the site.
---

# Add an article

<scope>
Articles share the docs plugin with guides — the Docusaurus blog plugin is disabled in this project. Use date frontmatter so articles can be ordered chronologically when listed.
</scope>

<instructions>
<step n="1">
**Pick a slug + date.** Slug: kebab-case, descriptive (e.g. `como-claude-code-mudou-meu-fluxo`). Date: ISO `YYYY-MM-DD`.
</step>

<step n="2">
**Create the file.** `docs/articles/<YYYY-MM-DD>-<slug>.md` (folder keeps articles grouped). Frontmatter:

```markdown
---
title: Título do artigo
description: Resumo de uma linha.
date: 2026-05-09
tags: [claude-code, fluxo]
---

# Título do artigo

Texto do artigo.
```
</step>

<step n="3">
**Sidebar position.** Articles sort newest-first inside the `articles/` category by default. Override with `sidebar_position` in frontmatter only if you need a specific order.
</step>

<step n="4">
**Update `static/llms.txt`.** Add a line under a `## Artigos` section (create the section the first time): `- [<title>](https://gazperi.com/educacao/articles/<file>.md) (<date>): <one-line summary>`.
</step>
</instructions>

<conventions>
- Articles stay in `docs/articles/`. Other guides keep their own structure.
- Date frontmatter is informational; sort order is filename-based (so the `<YYYY-MM-DD>-` prefix matters).
- If RSS / Atom feed is needed later, re-enable the blog plugin in a separate spec — do not silently flip it on here.
</conventions>

<antipattern>
- Creating an `articles/` entry without date prefix — sort order becomes unpredictable.
- Mixing articles into the top-level `docs/` flat list — clutters the sidebar.
</antipattern>