- Código
NS-4- Título
- Estrutura e redação dos Nexus Standards e documentos (v0.2: estrutura de cláusulas, formas verbais, requisitos registrados; elementos preliminares dos documentos)
- Versão
- 0.2.0
- Situação
- PROPOSTO
- Data
- catalogue 2026-10-16 · circulated 17 October 2026
- Unique Nexus Identifier
NXS-STD-ST-000010- Escopo de responsabilidade
- conhecimento
- Fonte
standards/NS-4-document-template.mdat2cbe0d41b5f8
Minuta de trabalho preparatória, circulada para revisão e comentários. Não deve ser implementada. Elaborado e divulgado por Saeed Valadbaygi, Chief Steward, Nexus Standards (saeed@therisk.global), 17 de outubro de 2026. Área de revisão técnica: TR-03. Este documento não é um Nexus Standard; pode mudar sem aviso prévio e não deve ser implementado, tomado como base nem citado como um Nexus Standard. Sua etapa é designada exclusivamente pelo Global Standards Council e por seus comitês técnicos nos termos de NS-13. Os destinatários são convidados a enviar comentários com as respectivas justificativas e a notificar quaisquer direitos de patente de que tenham conhecimento. Ver o aviso de circulação.
| Versão | 0.2.0 (working draft of the revision; on adoption it supersedes the 0.1 document template) |
| Situação | PROPOSTO · Proposta NXS-STD-PC-000010 |
| Prepared and circulated by | Saeed Valadbaygi, Chief Steward, Nexus Standards (saeed@therisk.global), 17 October 2026 |
| Etapa | Preparatory working draft, circulated for review and comment. Not for implementation. Stage designation reserved to the Global Standards Council (NS-13) |
| Proprietário | WG-DEV com os editores; comitê TC-CORE |
| Superior | NS-1; process NS-13 |
| Requisitos | NS4-R1 a NS4-R24, registrados em registry/requirements.yaml |
Citar
NS-4, Foreword. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-c-forewordForeword
This revision turns NS-4 from a document template into the drafting rules of the Nexus Standards. Version 0.1 fixed the front matter that gives a document its identity and provenance, and that front matter is retained unchanged in clause 9.
What 0.1 did not do was say how a standard states a requirement, how a reader distinguishes a requirement from advice, and how a conformance claim can be tested. Mature standards bodies settled these questions long ago [ISO-D2; RFC2119; RFC8174; W3C-P]. This revision adopts their settled practice in the Nexus voice and adds what a machine-readable programme needs: a register in which every requirement can be found, tested and traced.
Citar
NS-4, Introduction. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-c-introductionIntrodução
A standard is useful to the degree that two independent parties, reading it, reach the same judgement about whether a thing conforms. Four drafting disciplines serve that end:
- uma estrutura fixa, para que o leitor saiba onde procurar;
- a controlled vocabulary of obligation, so the reader knows what is required;
- requisitos atômicos, de modo que cada um possa ser testado isoladamente;
- a stated test, so the judgement does not depend on who makes it.
Citar
NS-4, clause 1. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-c-11. Âmbito
1.1 Este documento especifica:
Citar
NS-4, clause 1.1. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-c-1-1- the structure of Nexus Standards and of the specifications, policies and technical notes of the programme;
- the verbal forms that express requirements, recommendations, permissions and possibilities;
- as regras para redigir requisitos e para registrá-los;
- a folha de rosto e a estrutura de outros documentos do ecossistema (cláusula 9).
1.2 It applies to every document of categories ST (standard), PO (policy), TN (technical note) and PC (proposal) drafted after its adoption, and to every existing NS document when that document is next revised. Clause 9 applies to documents of categories RP, DC, DL, WP, PP, AR, BK, CP and TH.
Citar
NS-4, clause 1.2. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-c-1-21.3 Não especifica o conteúdo de nenhuma norma, o processo de desenvolvimento (NS-13) nem a avaliação de conformidade (NS-14 e NXS-STD-DC-000032).
Citar
NS-4, clause 1.3. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-c-1-3Citar
NS-4, clause 2. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-c-22. Referências normativas
The following documents are referred to in the text in such a way that some or all of their content constitutes requirements of this document. For dated references only the edition cited applies. For undated references the latest edition applies.
- NS-1, *Catálogo de identificadores e artefatos*
- NS-2, *Citation and attribution*
- NS-13, *Standards development process*
- NS-14, *Conformance and crosswalk*
registry/requirements.yaml, *Register of normative requirements* (NXS-STD-DS-000013)
Citar
NS-4, clause 3. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-c-33. Termos e definições
3.1 requisito: expressão no conteúdo de um documento que transmite critérios objetivamente verificáveis a serem cumpridos e dos quais não se admite desvio caso se pretenda alegar conformidade com o documento (segundo [ISO-D2]).
Citar
NS-4, clause 3.1. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-c-3-13.2 recommendation: an expression conveying that, among several possibilities, one is recommended as particularly suitable, without excluding others.
Citar
NS-4, clause 3.2. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-c-3-23.3 permission: an expression conveying consent or liberty to do something.
Citar
NS-4, clause 3.3. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-c-3-33.4 possibility: an expression conveying that something is materially, physically or causally possible.
Citar
NS-4, clause 3.4. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-c-3-43.5 conformance target: the kind of thing to which a requirement applies, for example a record, a dataset, a software release, an organisation or a process.
Citar
NS-4, clause 3.5. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-c-3-53.6 test method: the procedure by which conformance with a requirement is determined. It is one of:
Citar
NS-4, clause 3.6. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-c-3-6automated: by a published executable test;inspection: by examination of an artefact against stated criteria;audit: by examination of records and practice over a period;demonstration: pelo desempenho observado.
3.7 normative: content that a claimant must satisfy. informative: content that explains, illustrates or credits, and that a claimant need not satisfy.
Citar
NS-4, clause 3.7. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-c-3-7Citar
NS-4, clause 4. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-c-44. Structure of a standard
4.1 NS4-R5. Uma Nexus Standard deve conter os seguintes elementos nesta ordem. Um elemento marcado como condicional só pode ser omitido quando estiver vazio.
Citar
NS-4, NS4-R5. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-r-ns4-r5| Elemento | Tipo | Conditional |
|---|---|---|
| Título | normativo | não |
| Foreword (status, proposal, owners, relation to other documents, changes from the previous edition) | informative | não |
| Introdução (finalidade e justificativa) | informative | sim |
| 1 Scope (what the document covers, and what it does not) | normativo | não |
| 2 Referências normativas | normativo | não; declara "There are no normative references in this document." quando não há nenhuma |
| 3 Termos e definições | normativo | no; refers to the Nexus-native risk vocabulary for terms it does not define itself |
| 4 onwards: Requirements, organised by subject | normativo | não |
| Conformidade (alvos de conformidade, níveis, classes e como uma declaração é feita) | normativo | não |
| Annexes, each marked normative or informative | qualquer um | sim |
| Bibliography of informative references | informative | sim |
4.2 NS4-R6. The scope shall be written as statements of fact. It shall not contain requirements.
Citar
NS-4, NS4-R6. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-r-ns4-r64.3 NS4-R7. Uma referência normativa deve ser citada por identificador e, quando se pretende uma edição datada, por ano. O texto de um documento externo não deve ser reproduzido (NS14-R1).
Citar
NS-4, NS4-R7. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-r-ns4-r74.4 NS4-R8. A term defined in clause 3 shall be defined once, as a substitutable phrase without an article, and shall be used with that meaning throughout the document.
Citar
NS-4, NS4-R8. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-r-ns4-r84.5 Clauses are numbered in arabic numerals to at most four levels (4.2.1.3). Annexes are lettered (Annex A).
Citar
NS-4, clause 4.5. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-c-4-5Citar
NS-4, clause 5. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-c-55. Formas verbais
5.1 NS4-R9. As seguintes formas verbais devem ser usadas, e somente com estes significados.
Citar
NS-4, NS4-R9. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-r-ns4-r9| Formulário | Expressa | Negativo |
|---|---|---|
| deve | a requirement | shall not |
| should | a recommendation | não deve |
| pode | a permission | não precisa |
| pode | uma possibilidade ou capacidade | não pode |
5.2 NS4-R10. The words "must", "required", "mandatory" and "is to" shall not be used to express a requirement. The word "must" may appear only to describe an external constraint, such as a law of nature or a legal duty that the document does not itself create.
Citar
NS-4, NS4-R10. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-r-ns4-r105.3 As formas da cláusula 5.1 correspondem às palavras-chave de [RFC2119], conforme esclarecido por [RFC8174]. Um documento Nexus que também seja publicado como especificação da internet pode declarar essa correspondência.
Citar
NS-4, clause 5.3. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-c-5-3Citar
NS-4, clause 6. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-c-66. Requisitos de redação
6.1 NS4-R11. Cada requisito deve ser atômico: enuncia uma obrigação sobre um alvo de conformidade.
Citar
NS-4, NS4-R11. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-r-ns4-r116.2 NS4-R12. Each requirement shall be identified by a requirement identifier of the form <DOC>-R<n>, where <DOC> é o código curto do documento (por exemplo NS4, IHP, NRS-C17) e <n> é um número inteiro positivo. O identificador deve ser escrito em negrito no início da frase que contém o requisito. Os identificadores nunca são reutilizados. Um requisito retirado mantém seu identificador com o status WITHDRAWN.
Citar
NS-4, NS4-R12. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-r-ns4-r126.3 NS4-R13. A requirement shall be verifiable. It shall state, or refer to, the criteria by which conformance is judged. Words without a stated criterion, such as "appropriate", "adequate", "sufficient", "timely" and "state-of-the-art", shall not be used as the sole criterion of a requirement.
Citar
NS-4, NS4-R13. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-r-ns4-r136.4 NS4-R14. Um requisito que dependa de uma grandeza deve indicar a grandeza, sua unidade e sua tolerância, de acordo com a norma de unidades e medições do programa, uma vez adotada (NRS-C24 proposta).
Citar
NS-4, NS4-R14. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-r-ns4-r146.5 NS4-R15. Notes and examples shall be informative and shall not contain requirements.
Citar
NS-4, NS4-R15. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-r-ns4-r156.6 Um requisito pode remeter a outro documento. A referência a um requisito de outro documento cita o seu identificador.
Citar
NS-4, clause 6.6. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-c-6-6Citar
NS-4, clause 7. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-c-77. Registro de requisitos
7.1 NS4-R16. Every requirement of an adopted or proposed Nexus document shall be recorded in registry/requirements.yaml with the following:
Citar
NS-4, NS4-R16. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-r-ns4-r16- identificador;
- document UNI;
- clause;
- forma verbal;
- a meta de conformidade;
- the test method (clause 3.6);
- the reference of the executable test, where the method is
automated; - situação.
7.2 NS4-R17. A requirement shall have one of the statuses PROPOSED, IN_COMMENT, ADOPTED, SUPERSEDED or WITHDRAWN. O status de um requisito não deve adiantar-se ao status do seu documento.
Citar
NS-4, NS4-R17. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-r-ns4-r177.3 NS4-R18. O validador deve recusar:
Citar
NS-4, NS4-R18. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-r-ns4-r18- uma entrada de registro cujo identificador não aparece na cláusula que ela cita;
- a document requirement identifier that is not registered;
- an
automatedrequisito sem referência de teste quando o documento está em fase de comentários.
7.4 O registro é a fonte a partir da qual são geradas as listas de verificação de conformidade, as suítes de teste e as páginas de requisitos do site.
Citar
NS-4, clause 7.4. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-c-7-4Citar
NS-4, clause 8. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-c-88. Cláusula de conformidade
8.1 NS4-R19. The conformance clause shall state:
Citar
NS-4, NS4-R19. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-r-ns4-r19- the conformance targets;
- quaisquer níveis ou classes de conformidade;
- the requirements each level or class comprises;
- the form of a conformance claim.
8.2 NS4-R20. Uma declaração de conformidade deve citar:
Citar
NS-4, NS4-R20. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-r-ns4-r20- the document's UNI and version;
- the level or class claimed;
- the evidence quality level (EQL) of the supporting evidence;
- a data da reivindicação;
- a parte que a apresenta.
A claim never states or implies certification unless an accredited certification under the conformity assessment scheme supports it.
Citar
NS-4, clause 9. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-c-99. Elementos preliminares e estrutura de outros documentos
9.1 NS4-R1. O texto inicial (front matter), ou o UNIda primeira linha, deve estar presente em todo documento. O registro deve ser emitido antes de o documento ser compartilhado.
Citar
NS-4, NS4-R1. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-r-ns4-r1--- uni: NXS-GRX-RP-M002-000007 version: 1.2.0 title: ... creators: [{ name: ..., orcid: ... }] publisherRef: GCRI_CANADA publicationDate: 2026-10-16 legalState: LEGAL_REVIEW_REQUIRED claimCeiling: INTEGRATED derivedFrom: [NXS-GRX-DS-M002-000003@2.0.0] conformsTo: [NS-0, NS-1, NS-2, NS-4] language: en ---Plain Markdown without front matter starts with Nexus-UNI: <uni> on the first line (NS1-R5). HTML carries <meta name="nexus-uni"> and the Schema.org JSON-LD of the record (NS-7). Word, PDF and slide formats carry the UNI on the title page and in the document properties.
9.2 Os documentos que não são normas seguem esta estrutura:
Citar
NS-4, clause 9.2. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-c-9-2- Summary: what the document is, for whom, its supported claim level and its legal state, in one paragraph.
- Scope and definitions.
- Body.
- Evidências e proveniência: conjuntos de dados, registros, modelos e execuções, citados por UNI (NS-2).
- Limitations.
- Conformidade: as normas e cláusulas declaradas (NS-14).
- Referências.
- Registro de alterações.
9.3 NS4-R2. Todo número, figura e mapa de um documento deve citar seu UNI de origem (NS-2, NS-5).
Citar
NS-4, NS4-R2. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-r-ns4-r29.4 NS4-R3. The limitations section shall be present. It shall state the supported claim level and the legal state in plain words.
Citar
NS-4, NS4-R3. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-r-ns4-r39.5 NS4-R4. Versions shall be semantic in accordance with the maintenance procedure (NXS-STD-DC-000028). Um número ou uma conclusão alterados constituem uma nova versão, com uma linha no registro de alterações e um resumo criptográfico (digest).
Citar
NS-4, NS4-R4. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-r-ns4-r4Citar
NS-4, clause 10. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-c-1010. Linguagem e estilo
10.1 NS4-R21. Standards shall be written in plain, impersonal and precise language. Each sentence shall carry a single idea where a requirement is stated.
Citar
NS-4, NS4-R21. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-r-ns4-r2110.2 NS4-R22. As abreviações devem ser expandidas no primeiro uso em cada documento.
Citar
NS-4, NS4-R22. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-r-ns4-r2210.3 NS4-R23. No document shall name, promote or disparage a for-profit company, product or mark, except where a normative reference to a published standard requires it, and then only by the standard's identifier.
Citar
NS-4, NS4-R23. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-r-ns4-r2310.4 NS4-R24. O texto em inglês é o texto de referência. As traduções seguem a política sobre acessibilidade e idiomas (NXS-STD-PO-000002).
Citar
NS-4, NS4-R24. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-r-ns4-r24Citar
NS-4, clause 11. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-c-1111. Conformidade
11.1 O alvo de conformidade deste documento é um documento das categorias listadas em 1.2.
Citar
NS-4, clause 11.1. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-c-11-111.2 A document conforms to NS-4 when it satisfies NS4-R1 to NS4-R24 as they apply to its category. Requirements NS4-R5 to NS4-R20 apply to standards, policies, technical notes and proposals. Requirements NS4-R1 to NS4-R4 and NS4-R21 to NS4-R24 apply to every document.
Citar
NS-4, clause 11.2. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-c-11-2Citar
NS-4, Annex A. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-c-annex-aAnnex A (informative): changes from version 0.1
| Version 0.1 | Versão 0.2 |
|---|---|
| NS4-R1 a NS4-R4 (elementos pré-textuais, citação de números, limitações, versões semânticas) | Retained with the same identifiers in clause 9 |
| No structure for standards | Cláusula 4 |
| Sem formas verbais | Cláusula 5 |
| Regras em tabelas | Requisitos atômicos, identificados e verificáveis (cláusula 6) |
| No register | Cláusula 7 |
| No conformance clause rule | Clause 8 |
Citar
NS-4, Bibliography. NXS-STD-ST-000010@0.2.0. https://nexustandards.com/standards/ns-4/#nx-c-bibliographyBibliografia
[ISO-D2], [RFC2119], [RFC8174], [W3C-P] em governance/programme/BIBLIOGRAPHY.md.
Histórico de alterações
Versions from the catalogue; entries from the changelog that name this document.
| Versão | Data | Nota |
|---|---|---|
0.1.0 | 16 de outubro de 2026 | current version in the catalogue |
- Unreleased NS-13 proposal
NXS-STD-PC-000010(OPEN, política), proposto por Saeed Valadbaygi, Guardião-Chefe: o primeiro programa de trabalho. Emgovernance/programme/: bibliografia (NXS-STD-DC-000027); política sobre informações perigosas e conteúdos de uso duplo (NXS-STD-PO-000001, observado por precaução enquanto se aguarda o Conselho); procedimento de manutenção (NXS-STD-DC-000028); especificação do modelo NHS-2 (NXS-STD-TN-000001); novos itens de trabalho NRS-C17 a NRS-C24 (NXS-STD-DC-000029); termos de referência das linhas de trabalho (NXS-STD-DC-000030); convites e canais (NXS-STD-DC-000031); política de acessibilidade e idiomas (NXS-STD-PO-000002); esquema de avaliação da conformidade (NXS-STD-DC-000032); nota de apresentação (NXS-STD-DC-000033). Também: NS-4 versão 0.2 (estrutura e redação).registry/requirements.yaml(NXS-STD-DS-000013, 108 requisitos) eregistry/information-hazard-screen.yaml(NXS-STD-DS-000014), ambos aplicados pelo validador. Quatro chamadas específicas emregistry/participation.yaml. - 0.2.0 – 2026-10-16 Constituição NS-0; NS-2, NS-4, NS-5, NS-9, NS-10, NS-11, NS-12, NS-13, NS-14 redigidas (PROPOSTAS). Categorias DP, PR, CL, AT; esquema de registro v1.1 com o contexto da NS-9; esquemas de cláusula, política, atestação e proposta.