NMWDI Specification Governance model

Owned by Jake Ross
Last updated: Aug 15, 2023 by Rachel Hobbs
1 min read

Table of Contents

 

Rules for Making Updates to Groundwater Specification

  1. Specification shall always be publicly available

  2. Specification shall adhere to style as defined in the NMWDI style guide

  3. Modification of the specification requires consent of majority of the active TWG members

    1. Could be presented for review ahead of time for TWG members to review and approve at next meeting

    2. Information that should be included: what needs to change and why

  4. Changes in new version should be documented

 

The Zen of NMWDI

(inspired by PEP 20 – The Zen of Python | peps.python.org )

Duplication is wasteful, linking is better Data first, Apps second Share the data you collect Explicit is better than implicit Consistent is good, standardized is better, validation is essential Be Robust. (Postel's Law: Be conservative in what you do, be liberal in what you accept from others.)

 

Style Guide

Rules:

  1. All lower case

  2. underscores between words

  3. spell out full words for clarity

  4. use nested properties instead of name qualifiers

 

Specification Enhancement Proposal Template