Skip to content

fix(docs): preserve indexed legacy URLs and canonical documentation - #131

Merged
vitormattos merged 1 commit into
mainfrom
fix/documentation-permalinks-seo-20261109
Nov 9, 2026
Merged

vitormattos merged 1 commit into
mainfrom
fix/documentation-permalinks-seo-20261109

Conversation

@vitormattos

Copy link
Copy Markdown
Member

Objetivo

Preservar os endereços históricos já indexados de docs.libresign.coop e impedir que futuras publicações substituam artigos antigos por índices genéricos.

Alterações

  • Registra 46 rotas antigas com destinos fixos e verificáveis; 35 páginas que antes eram desviadas para índices genéricos passam a apontar para os respectivos artigos preservados no manual de desenvolvimento (main), enquanto 11 apontam para páginas equivalentes da versão 15.
  • Falha antes da publicação se um destino histórico desaparecer; preserva o mapeamento quando uma nova release estável surgir.
  • Gera sitemap.xml, robots.txt e links rel=canonical para o domínio de produção; marca páginas auxiliares e previews de PR com noindex.
  • Mantém os contratos OpenAPI e a separação de releases; os textos de main permanecem identificados como documentação de desenvolvimento, não homologação de comportamento em 13–15.
  • Inclui testes de migração, canonicals, sitemap, destinos ausentes, URLs inseguras, prévias e fixtures.

Evidências de validação

  • 42 testes Python passaram: python3 -m unittest discover -s tests -q.
  • 12 testes JavaScript passaram: node --test tests/js/*.test.mjs.
  • Build integral de 13/14/15/main e verificação de contratos: python3 -m versioning.build --output ... + python3 -m versioning.verify --output ... passaram.
  • Montagem atômica do site e verificação final: python3 -m versioning.publish ... + python3 -m versioning.verify ... passaram (134 páginas HTML de conteúdo/apoio verificadas pelo validador).
  • Commit com assinatura OpenPGP verificada e DCO.

Limites e revisão

  • GitHub Pages gera arquivos HTML de redirecionamento (meta refresh) e não responde automaticamente com HTTP 301/308. O objetivo imediato é manter destinos relevantes e estáveis; mudanças para HTTP 301/308 exigem infraestrutura na borda.
  • Não é possível garantir posicionamento no Google ou substituir métricas do Search Console por testes locais.
  • O trabalho de recuperar e atualizar os manuais estáveis de usuário e administrador é uma etapa posterior; não fazer merge automático.
  • Revisar possíveis conflitos com o PR refactor(docs): document each LibreSign release in its own branch #130, especialmente a precedência de conteúdo compartilhado entre main e versioned/base.

Relacionado a #126, #127, #128, #129 e #130.

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
@vitormattos
vitormattos marked this pull request as ready for review November 9, 2026 19:13
@vitormattos
vitormattos merged commit 9c39168 into main Nov 9, 2026
2 of 4 checks passed
@vitormattos
vitormattos deleted the fix/documentation-permalinks-seo-20261109 branch November 9, 2026 19:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant