Fix OrganisationRegistrationAgency codelist description

[andylolz]

The OrganisationRegistrationAgency codelist description includes the following sentence:

IATI replicates the list directly from org-id.guide with the exception of the XI-IATI codelist.

I think this may be incorrect for two reasons:

• I don’t think IATI replicates the list from org-id.guide. The IATI list has only been updated a couple of times since the switchover. I’ve created an issue (Update Organisation Registration Agency from org-id.guide? #235) and sent a one-off pull request to address that (Update org reg agency codelist from org-id.guide #247) but I suppose keeping the lists in sync longterm is related to Pull external codes automatically including withdrawn (historic) codes #172.
• I’m not sure what the “with the exception of the XI-IATI codelist” bit means. The XI-IATI code is included on org-id.guide, and the IATI OrganisationRegistrationAgency codelist.

@timgdavies already made the first point just here: https://github.com/andylolz/org-id-finder/issues/6#issuecomment-363868555, and the second point just here: #166 (comment)

[stevieflow]

Thanks @andylolz

I'd written some updated description text for this list, in the assumption that the synch/update with org-id wil lbe put in place

See stevieflow@fc413c6 - but here's the text anyway -

Im also minded that should we accept this update, it will need to be updated across different versions

The values from this codelist are used to identify the particular list that an organisation identifier was drawn from. The codelist provides a register of known identifier lists, including national company registers, NGO directories and international and multilateral organisation lists - along with guidance and online resources to help locate the identifiers assigned to a specific organisation.

As of 17 July 2017 this list is maintained by the org-id.guide project. Data publishers can now search for and locate the relevant list for a particular organisation identifier using the org-id website. The full register of identifier sources is also available to download in XML, JSON and CSV format.

IATI periodically replicates the codelist of identifier sources from org-id.guide, to assist those accessing IATI documentation. However, it is advised that the most up-to-date source is the org-id.guide project

If org-id.guide does not contain an entry for the kind of organisation you need to identify, you can make a request a new list is included in the register following the guidance at http://docs.org-id.guide/en/latest/contribute/ or by getting in touch with contact@org-id.guide.

[andylolz]

in the assumption that the synch/update with org-id wil lbe put in place

I don’t think we should assume this. I think this needs bottoming out before revising the wording.

However, it is advised that the most up-to-date source is the org-id.guide project

See Tim’s comment about “org-id.guide project”: #166 (comment)

it will need to be updated across different versions

Yes… But since non-embedded codelists are the same across all versions, this should Just Happen™ on deployment.

[andylolz]

Great – this has been merged and deployed! Thanks all.