Skip to content

fix(docs): keep stable release overrides above shared development content - #134

Merged
vitormattos merged 1 commit into
mainfrom
fix/stable-doc-shared-source-precedence
Nov 9, 2026
Merged

vitormattos merged 1 commit into
mainfrom
fix/stable-doc-shared-source-precedence

Conversation

@vitormattos

Copy link
Copy Markdown
Member

Problema

Ao montar o manual de uma release estável, source_tree() copiava primeiro versioned/base/ e depois os diretórios compartilhados do manual de desenvolvimento. Isso fazia com que developer_manual/integration/_native-webhooks.inc da linha de desenvolvimento substituísse o aviso estável de polling nas versões 13, 14 e 15.

Correção

Muda a ordem para shared → stable base → overlay por major. Os trechos reutilizáveis continuam sendo herdados, mas o aviso intencional de uma release estável prevalece. O overlay específico da próxima versão mantém precedência máxima.

O teste existente de tests/test_shared_sources.py foi reforçado: a fixture contém um aviso diferente no compartilhado, e asserções verificam as três origens (estável, próxima major e desenvolvimento). Assim a regressão falha com o código anterior.

Relação com outros PRs

Esta correção pontual já estava incluída no PR #130, que também possui documentação extensa de webhooks ainda em rascunho. Foi extraída para permitir corrigir imediatamente o vazamento entre versões, sem antecipar a publicação de recursos não estáveis. Ao retomar o #130, remover/reconciliar o trecho idêntico na rebase; não duplicar a implementação.

Validação

  • Commit assinado com OpenPGP e DCO.
  • A CI do GitHub deve confirmar isolamento por versão, Sphinx e contratos OpenAPI.
  • A CI de prévia só ficará íntegra após a correção independente de testes no PR fix(docs): repair preview CI for legacy redirects #132; este PR não modifica as rotas nem os redirects.

Escopo

Sem alterações no conteúdo de webhooks, na API da aplicação ou na publicação do futuro LibreSign 16.

…anuals

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
@vitormattos
vitormattos merged commit 0369067 into main Nov 9, 2026
2 of 3 checks passed
@vitormattos
vitormattos deleted the fix/stable-doc-shared-source-precedence branch November 9, 2026 20:06
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