Skip to content

Commit

Permalink
chore: clean up iso house style blog post
Browse files Browse the repository at this point in the history
  • Loading branch information
ronaldtse committed Mar 3, 2024
1 parent 1d84bd1 commit 10307b7
Showing 1 changed file with 16 additions and 7 deletions.
23 changes: 16 additions & 7 deletions _posts/2023-05-11-updated-iso-house-style.adoc
Original file line number Diff line number Diff line change
@@ -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:
Expand All @@ -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.

0 comments on commit 10307b7

Please sign in to comment.