From dc1b6c3ab7ec42af5f8a91a9f2b6b5f933d8d36b Mon Sep 17 00:00:00 2001 From: Arthit Suriyawongkul Date: Wed, 23 Sep 2026 06:05:24 +0100 Subject: [PATCH] Reference: Add ISO verbal forms Signed-off-by: Arthit Suriyawongkul --- docs/conformance.md | 18 ++++++++++++++++++ docs/references.md | 4 ++++ 2 files changed, 22 insertions(+) diff --git a/docs/conformance.md b/docs/conformance.md index 480f52aca88c..f42586b4de16 100644 --- a/docs/conformance.md +++ b/docs/conformance.md @@ -1,5 +1,23 @@ # Conformance +## Verbal forms for expressions of provisions + +In this document, the following verbal forms are used to express the level of +normativity of a provision: + +- "shall" and "shall not" indicate a requirement; +- "should" and "should not" indicate a recommendation; +- "may" indicates a permission; +- "can" and "cannot" indicate a possibility or a capability. + +Conformance to this document is determined by its requirements alone. +Recommendations and permissions do not affect conformance. + +These verbal forms are written in lower case, and follow the conventions of the +ISO/IEC Directives, Part 2, [Clause 7][verbal]. + +[verbal]: https://www.iso.org/sites/directives/current/part2/index.xhtml#_idParaDest-29 + ## Alternate notation for some conformance requirements This document contains more than a few cardinality assertions, each of which diff --git a/docs/references.md b/docs/references.md index ce75649513f3..3ffb74e784d6 100644 --- a/docs/references.md +++ b/docs/references.md @@ -62,6 +62,10 @@ European Commission, *ISO/IEC 24765:2017 Systems and software engineering — Vocabulary*, [https://www.iso.org/standard/71952.html](https://www.iso.org/standard/71952.html). +*ISO/IEC Directives, Part 2,* +*Principles and rules for the structure and drafting of ISO and IEC documents*, +. + *npm-package.json*, npm Inc., [https://docs.npmjs.com/files/package.json](https://docs.npmjs.com/files/package.json).