Disciplina de citação

Spec: ISO/IEC/IEEE 26514 Spec: ISO 24495-1 Evidence: Editorial

Visão geral

Esta é a página para a qual o restante do Insider_ aponta quando menciona “nível de evidência”. Ela explica por que estes documentos parafraseiam os padrões em vez de citá-los, como uma afirmação se vincula a um reference ID que você pode reverificar e o que cada um dos oito níveis de evidência promete ou não promete.

Ela foi escrita para um engenheiro sênior que, antes de confiar em uma afirmação, quer conhecer as regras usadas para formulá-la — e tem razão em querer isso.

Por que isso importa

Todas as outras páginas do Insider_ fazem afirmações e as marcam com um nível de evidência. Essa marca só tem valor se o sistema por trás dela for explícito. Se “standard-backed” pudesse significar qualquer coisa entre “li a especificação com atenção” e “lembro mais ou menos do que ela dizia”, o selo seria mera decoração.

Há também uma restrição mais difícil. Muitos dos documentos aos quais o NextPDF responde — as especificações da ISO, da ETSI e similares — são licenciados. Reproduzir o texto deles, em qualquer extensão, não é permitido. Portanto, a disciplina precisa resolver dois problemas ao mesmo tempo: tornar uma afirmação verificável em relação à sua fonte, sem reproduzir essa fonte. A resposta para ambos é o mesmo mecanismo, e esta página é a especificação dele.

A versão resumida

O Insider_ parafraseia os padrões e nunca cita padrões licenciados. Uma afirmação cita o padrão, a cláusula e um reference ID; ela não reproduz as palavras do padrão.
A paráfrase não é um atalho; é um teste de compreensão. Reformular um requisito na voz própria do NextPDF obriga o redator a entendê-lo e mantém a terminologia consistente com o glossário Spec: ISO/IEC/IEEE 26514, §8 .
Toda afirmação standard-backed carrega um reference_id de 64 caracteres no front-matter citations da página, para que o próximo revisor possa recuperar o trecho exato da fonte e confirmar a paráfrase.
O selo declara um nível de evidência — um de oito tipos — que informa o tipo de prova, de modo que uma afirmação exagerada fica visível à primeira vista.
Quando a fonte não pode ser recuperada, a afirmação não é forjada. Ela é mantida, marcada como não resolvida em um registro de re-pin, e a página permanece não publicada — um protocolo documentado, não uma improvisação.

Como o NextPDF aborda isso

Paráfrase, não citação

A regra mais rígida na hierarquia de estilo do NextPDF prevalece sobre qualquer guia upstream: nenhum texto literal de um organismo de padronização licenciado, por mais curto que seja o trecho. Em vez disso, a página cita o padrão e a cláusula, parafraseia o requisito em sua própria voz e registra o reference ID da fonte.

Isso costuma ser tratado como uma restrição de licenciamento, e de fato é. O enquadramento mais útil é editorial. Uma citação literal prova apenas que você sabe copiar. Uma paráfrase fiel mostra que você entendeu a cláusula bem o suficiente para reformulá-la sem alterar seu sentido. Ela também permite que a frase permaneça no vocabulário consistente do NextPDF, em vez de trocar de registro no meio da página, como exige o modelo de qualidade de documentação Spec: ISO/IEC/IEEE 26514, §8 . A linguagem simples é avaliada por saber se um leitor consegue encontrar, entender e usar o conteúdo, não por saber se a prosa espelha a fonte Spec: ISO 24495-1, §Introduction ; a paráfrase atende a esse critério, a citação não.

Uma afirmação é vinculada a um reference ID, não a uma memória

O mecanismo que torna uma paráfrase verificável é o reference ID. Toda afirmação standard-backed carrega um reference_id completo de 64 caracteres no front-matter citations da página, identificando o trecho exato da fonte a partir do qual a paráfrase foi feita. Um revisor não precisa confiar na memória do redator; ele recupera novamente esse trecho e compara. O reference ID é o elo entre uma fonte que não pode ser citada e uma afirmação verificável. Ele carrega onde a prova está sem carregar o texto da prova.

O nível de evidência diz que tipo de prova é esta

Uma citação responde “de onde”. O nível de evidência responde “de que tipo”. Toda página do Insider_ declara um, exibido na linha de selos, extraído de um conjunto fixo de oito. A ordem de confiança coloca código e testes acima do runtime, runtime acima de metadados e metadados acima da prosa; uma página editorial não finge ser code-backed.

Nível de evidência	O que ele promete	O que ele não promete
Evidence: Code-backed	A afirmação é verificada contra o código-fonte do engine ou um exemplo executável	Que um padrão o exige
Evidence: Standard-backed	A afirmação é ancorada em uma cláusula citada e parafraseada com um reference ID	Que o código atualmente o implementa sem exceção
Evidence: Test-backed	Um teste na suíte mantém o comportamento fixo	Um número de desempenho
Evidence: Benchmark-backed	Uma medição sob um método declarado sustenta o número	O mesmo número no seu hardware
Evidence: Artifact-backed	Um artefato produzido (uma saída de build, um relatório) demonstra isso	Uma exigência de padrões
Evidence: Design principle	Uma decisão de projeto deliberada e fundamentada	Uma medição empírica
Evidence: Editorial	Uma explicação fundamentada que organiza outras evidências	Uma nova garantia comportamental própria
Evidence: Mixed evidence	A página combina bases e diz qual, por afirmação	Uma única base limpa

Esta página é Evidence: Editorial : ela não afirma nenhum comportamento próprio do engine. Ela explica o sistema do qual os selos das outras páginas dependem. Esse é o nível honesto para ela, e declará-lo é aplicar a disciplina a si mesma.

Quando a fonte não pode ser recuperada

A recuperação nem sempre está disponível. A integridade da disciplina aparece no que acontece nesse caso. Uma fila normal, um limite de taxa ou uma pausa de orçamento não é indisponibilidade. O redator espera. Uma indisponibilidade genuína aciona um fallback documentado: a afirmação é mantida, anexada à evidência no repositório e à referência de padrões que o próprio código declara, explicitamente marcada como não resolvida em um registro de re-pin permanente, e a página permanece não publicada até que o reference ID seja realmente fixado.

As manobras proibidas são enumeradas e verificáveis: um reference ID fabricado, um valor preenchido ou prefixado para parecer real, uma cláusula escrita de memória e disfarçada como citação recuperada, ou apagar silenciosamente a afirmação para escapar da citação. Uma indisponibilidade corretamente marcada em um rascunho é dívida com registro no ledger, não um defeito. Uma verificação offline e determinística impõe exatamente essa distinção.

O que a evidência diz

Esta página é Evidence: Editorial , portanto sua própria base é a governança de documentação neste repositório, somada aos padrões que justificam a disciplina. As afirmações aqui são verificáveis de duas maneiras: lendo as regras no repositório e recuperando novamente as cláusulas citadas.

Afirmação	Base	Âncora
A paráfrase força a compreensão	Padrão	Linguagem simples avaliada pelo uso do leitor, não pelo espelhamento da fonte Spec: ISO 24495-1, §Introduction
A terminologia permanece consistente	Padrão	Cada termo usado de forma consistente em todo o documento Spec: ISO/IEC/IEEE 26514, §8
A revisão faz parte do processo	Padrão	Testes de verificação e validação dentro do desenvolvimento Spec: ISO/IEC/IEEE 26513, §Foreword
O nível de evidência é reconhecível em primeiro lugar	Padrão	Reconhecimento em vez de recordação Spec: ISO 9241-110, §5.6.2
Nenhum texto licenciado literal; fixado por referência	No repositório	`docs/style/nextpdf-overrides.md` §5; `composer docs:jaccard-fingerprint`
O fallback de indisponibilidade é um protocolo real	No repositório	A governança normativa de fallback do RAG + a verificação offline `docs:rag-fallback-check` (o gate)

Exemplo prático

A disciplina é concreta: ela aparece na estrutura do front-matter citations de uma página. Cada entrada é o recibo de uma afirmação.

citations:
  - spec: "ISO 32000-2"
    clause: "§6"
    # full 64-char reference ID — the join to the source span, re-verifiable
    reference_id: "<64-hex digest>"
    # NextPDF-worded topic — the paraphrase, never the standard's text
    topic: "A writer's created or amended PDF elements must conform and stay consistent"

Não há campo quote, por design. O topic é a reformulação própria do NextPDF. O reference_id é o caminho pelo qual um revisor volta à fonte exata para conferir essa reformulação. O recibo carrega o ponteiro para a prova, não as palavras da prova.

Equívoco comum

A armadilha é ler “parafraseie, não cite” como uma evasiva — um jeito de soar autoritativo sem se comprometer. É o contrário. Uma citação não compromete com nada; ela toma emprestadas as palavras de outra pessoa. Uma paráfrase citada compromete o redator com uma reformulação que um revisor pode confrontar com a fonte. A disciplina torna as afirmações mais responsáveis, não menos.

A segunda armadilha é tratar “editorial” como um grau mais fraco de “standard-backed”. Não é um grau, de modo algum; é um tipo diferente. Uma página editorial como esta organiza e explica outras evidências. Ela está rotulada corretamente. E o rótulo é o ponto central: o sistema funciona porque uma página informa a você que tipo de prova está oferecendo antes que você decida quanto peso lhe dar.

Limites e fronteiras

Esta página especifica a disciplina de citação; ela não é a folha de estilo, a governança de fallback nem o código do gate. Os artefatos autoritativos estão no repositório (docs/style/nextpdf-overrides.md §5, a governança normativa de RAG-fallback, os scripts composer.jsondocs:*) e prevalecem sobre qualquer resumo aqui se houver divergência. Ela não afirma nenhum comportamento do engine.

A disciplina vincula a afirmação, não a conclusão do leitor. Uma paráfrase citada com fidelidade diz a você o que uma cláusula exige. Decidir se a leitura do NextPDF corresponde à sua obrigação precisa ainda é responsabilidade sua, e é por isso que as páginas comportamentais também carregam evidência code-backed ou test-backed, não apenas standard-backed. A imposição é parcial por admissão honesta: a verificação offline de fallback está ativa, e os verificadores de citação literal e de citação ao vivo estão conectados, com seus executores exaustivos ainda em conclusão — declarado como em andamento, não como concluído.

Documentos relacionados

Documentação como produto — a disciplina de qualidade mais ampla da qual este sistema de citação faz parte.
O panorama dos padrões — os padrões aos quais estas citações apontam e como uma cláusula se torna comportamento documentado.
A pirâmide de testes do NextPDF — o que significa evidência test-backed quando uma página reivindica esse nível em vez deste.

Glossário

Disciplina de citação — o conjunto de regras que governa como uma afirmação do Insider_ é vinculada à sua fonte: parafrasear, citar a cláusula, fixar um reference ID e nunca citar um padrão licenciado.
Paráfrase — uma reformulação de um requisito na voz própria do NextPDF, consistente com o glossário; o teste de compreensão que substitui a citação.
reference_id — o ponteiro de integridade completo de 64 caracteres para o trecho exato da fonte a partir do qual uma paráfrase foi feita, registrado para que um revisor possa recuperá-lo novamente e verificá-lo.
Nível de evidência — o tipo declarado de prova por trás das afirmações de uma página, um de oito (code-, standard-, test-, benchmark-, artifact-backed, design-principle, editorial, mixed), exibido na linha de selos.
Citação não resolvida — uma afirmação cujo reference ID não pôde ser fixado por causa de uma indisponibilidade genuína de recuperação; mantida, marcada em um registro de re-pin e retida da publicação em vez de ser forjada.