logo hsb.horse

Registro de Decisão de Arquitetura

Política de introdução do Glossário para separar posts de blog e conteúdo de conhecimento

Separar conteúdo cronológico em blog e conteúdo de referência de longo prazo em glossary, com URLs, coleção e navegação independentes.

Aceito #content #glossary #blog #information-architecture #seo

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 glossary e implementar páginas de lista/detalhe em /glossary e /{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 blog e diferenciar apenas por tags.
  • Option B: Separar em blog e glossary (escolhida).
  • Option C: Separar apenas convenções de nome agora e adiar a implementação.

Rationale

  • O modelo de leitura fica explícito: blog orientado por linha do tempo vs glossary orientado 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 glossary em src/content.config.ts.
  • Criar content/glossary/ e gerar IDs baseados em lang + slug.
  • Adicionar rotas estáticas em src/pages/glossary/* e src/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.