Documentação como código, reescrita a partir do código

A documentação antiga não servia de fonte: tinha função que não existia mais e comportamento descrito errado. A decisão foi tratá-la como código.

Uma fonte só

As docs vivem em Markdown no repositório do núcleo, no mesmo caminho nos dois idiomas, em quatro áreas: guias, conceitos, referência e novidades. Cada arquivo declara de quais fontes depende e em que commit foi conferido.

Três comandos

• c2f docs:audit aponta o que ficou para trás em relação ao código.
• c2f docs:extract tira do código o bloco de funções de cada biblioteca.
• c2f docs:build transforma o Markdown nos recursos do próprio sistema: páginas, publicações, menu e índice com busca.

O que foi reescrito

Os conceitos, as 41 bibliotecas e os 32 módulos, em português e inglês, sempre confirmando o comportamento no código antes de escrever. O resultado está em /docs/, com um índice em texto para agentes de IA.

Origem: Core · req-176 a req-185 · BATCH-181 a BATCH-189