tantek.com

New issue on

GitHub project “w3process”


Normative prose for role of Chair / Team Contact cites informative reference for description

on (ttk.me b/5R02) using BBEdit

There are two sentences of normative prose that cite the informative Art of Consensus as [GUIDE] in the Informative References.

The two sentences are in the Requirements for All Chartered Groups, specifically these two:

The role of the Chair [CHAIR] is described in the Art of Consensus [GUIDE].

...

The role of the Team Contact [TEAM-CONTACT] is described in the Art of Consensus [GUIDE].

It is inconsistent and misleading for a normative sentence to claim that a description (implied to be normative from that context) is written in an informative reference.

It also seems like a bad practice to import via prose "is described in " and essentially upgrade-by-reference external informative content into normative context.

The relatively quick short-term fix would be to mark those quoted sentences of prose non-normative. E.g. move the above quoted sentences to their own class="note" role="note" paragraphs as:

Note: The role of the Chair [CHAIR] is described in the Art of Consensus [GUIDE].
Note: The role of the Team Contact [TEAM-CONTACT] is described in the Art of Consensus [GUIDE].

respectively. That way the inline prose is clearly non-normative, consistent with the informative imports from and citations of the Art of Consensus [GUIDE]. We will work on a Pull Request to address this.

Label: Needs Proposed PR