Include a reference to RFC 2119

[andylolz]

The IATI Standard uses the capitalised keywords "MUST", "SHOULD" etc throughout, but I don’t think it explicitly references RFC 2119 (where these keywords are defined).

RFC 2119 recommends the following:

Authors who follow these guidelines should incorporate this phrase near the beginning of their document:

The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL
NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and
"OPTIONAL" in this document are to be interpreted as described in
RFC 2119.

It would be good to add this.

[samuele-mattiuzzo]

I wonder if that's where our wording comes from, will drag @amy-silcock into this as she might know better

[andylolz]

Great – thanks.

Apart from this API documentation (which I presume was a precursor to the datastore API?) I wasn’t able to find a reference to it.

[amy-silcock]

As far as I know we don't reference it. As part of the standardising the standard work it's something we're looking to add!

And to use the wording around and capitalisation of must/should etc. consistently.

[samuele-mattiuzzo]

I'm going to mark this as blocked pending internal planning for the moment, since we're also undergoing a merge of the Reference Site into the main iatistandard.org portal, and possibly worth looking at this as a part of the whole chunk of work

/cc @andylolz ^

[andylolz]

Great – thanks both

[akmiller01]

Just thinking of where to properly place this reference, I realized that our entire reference.rst file in this repository is essentially unused. It only contains a toctree that's repetitive to the side menu. So maybe we could use that page to cite references like RFC2119 like this: #661