logo hsb.horse

Registro de Decisão de Arquitetura

Gestão do catálogo de ferramentas

Gerenciar a lista de ferramentas com Content Collection em YAML e construir ferramentas individuais como páginas implementadas.

Aceito #tools #content #architecture

Gestão do catálogo de ferramentas

Decisão

  • Gerenciar a lista de /tools com uma Content Collection usando YAML.
  • Cada entrada YAML representa metadados de uma ferramenta.
  • Armazenar title / description localizados dentro da própria entrada YAML.
  • Não gerar automaticamente páginas /tools/<slug> a partir do catálogo; páginas de ferramenta devem ser implementadas.
  • Tratar url iniciando com / como link interno; caso contrário, como externo.
  • Manter categorias flexíveis (sem enum fixo).

Contexto

Páginas de ferramenta exigem implementação (ex.: gerador de UUID), então geração baseada em Markdown não é adequada. Ao mesmo tempo, a lista /tools precisa de tags/categorias para filtros e deve ser fácil de atualizar.

Alternativas

  • Markdown: conteúdo de corpo desnecessário.
  • TS/JSON: seguro por tipo, mas mais orientado a código para atualização.
  • CMS externo: pesado demais para um site pessoal.

Consequências

  • A lista é atualizada por alterações em YAML.
  • As páginas de ferramenta permanecem livres para implementação.
  • category e tags podem ser usados para busca e filtragem.