From 10307b78ff0d02155ff9184989441c5b018fe488 Mon Sep 17 00:00:00 2001 From: Ronald Tse Date: Sun, 3 Mar 2024 23:16:47 +0800 Subject: [PATCH] chore: clean up iso house style blog post --- .../2023-05-11-updated-iso-house-style.adoc | 23 +++++++++++++------ 1 file changed, 16 insertions(+), 7 deletions(-) diff --git a/_posts/2023-05-11-updated-iso-house-style.adoc b/_posts/2023-05-11-updated-iso-house-style.adoc index 80ffd0ed..9b718705 100644 --- a/_posts/2023-05-11-updated-iso-house-style.adoc +++ b/_posts/2023-05-11-updated-iso-house-style.adoc @@ -1,6 +1,6 @@ --- layout: post -title: 'Validating against ISO House Style' +title: Validating against ISO House Style date: 2023-05-11 categories: documentation authors: @@ -15,19 +15,28 @@ excerpt: >- has been updated to the 2023 version of the style guide. --- -In link:/blog/2022-03-13-iso-house-style.adoc/[Validating against ISO House Style], -we noted that Metanorma-ISO now validates ISO documents against the ISO House Style, -issuing various warnings for wording and punctuation to ensure compliance against -that style guide. +Metanorma-ISO validates ISO documents against the +https://www.iso.org/ISO-house-style.html[ISO House Style], +issuing various warnings for wording and punctuation to ensure compliance +against that style guide. -The implementation of ISO House Style validation has now been updated to the 2023 -version of the style guide. The following rules have been added: +Metanorma first implemented validation of the ISO House Style in 2022 +(see link:/blog/2022-03-13-iso-house-style[Validating against ISO House Style]). + +The implementation of ISO House Style validation has now been updated to the +2023 version of the style guide. + +The following rules have been added: * https://www.iso.org/ISO-house-style.html#iso-hs-s-text-r-s-need[Need to], https://www.iso.org/ISO-house-style.html#iso-hs-s-text-r-s-might[might & could]: Warn of ambiguous provision wording. + * https://www.iso.org/ISO-house-style.html#iso-hs-s-text-r-s-quantity[Quantities and units]: Warn of more than one level of nesting of subscripts. + * https://www.iso.org/ISO-house-style.html#iso-hs-s-text-r-r-ref_unnumbered[Cross-references to an unnumbered document]: Superscript cross-references must follow punctuation. +Please feel free to contact the Metanorma team for additional (or modified) +validation rules if desired.