Política de introdução do Glossário para separar posts de blog e conteúdo de conhecimento
Decision
- Conteúdo cronológico (problema, investigação, solução) permanece em
blog. - Conteúdo de referência de longo prazo, como definições, notas de especificação e tabelas comparativas, vai para
glossary. - Adicionar a coleção
glossarye implementar páginas de lista/detalhe em/glossarye/{lang}/glossary. - Não migrar imediatamente os conteúdos já existentes em
blog; aplicar a nova classificação primeiro ao conteúdo novo.
Context
Atualmente, notas de conhecimento e posts de blog estão misturados em blog.
Isso deixa menos clara a navegação para leitores e também as regras de operação editorial.
- Post de blog: contexto temporal e sequência de publicação importam
- Conteúdo de conhecimento: atualização contínua e reutilização importam
Com apenas uma coleção, intenção de UI, linking interno e intenção de SEO ficam misturados.
Options
- Option A: Manter tudo em
bloge diferenciar apenas por tags. - Option B: Separar em
blogeglossary(escolhida). - Option C: Separar apenas convenções de nome agora e adiar a implementação.
Rationale
- O modelo de leitura fica explícito:
blogorientado por linha do tempo vsglossaryorientado a referência. - A separação por coleção facilita otimizações futuras de UI por tipo de conteúdo (ordenação, filtros, destaque).
- Separar URLs torna a intenção das páginas mais clara para mecanismos de busca.
Consequences
- Adicionar o schema da coleção
glossaryemsrc/content.config.ts. - Criar
content/glossary/e gerar IDs baseados emlang + slug. - Adicionar rotas estáticas em
src/pages/glossary/*esrc/pages/[lang]/glossary*. - Adicionar textos do glossary aos dicionários i18n.
- Migrar conteúdo existente de forma gradual e definir política de redirecionamento em ADR separado se necessário.
hsb.horse