site-com/documentation/add-article.md

---

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

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.

Pick a slug + date. Slug: kebab-case, descriptive (e.g. como-claude-code-mudou-meu-fluxo). Date: ISO YYYY-MM-DD.

Create the file. docs/articles/<YYYY-MM-DD>-<slug>.md (folder keeps articles grouped). Frontmatter:

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

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.

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

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

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