I’ve been encouraging publishers I work with to include a
document-link that goes back to a web page / document they maintain, which provides context about their IATI process/policy/publication.
Hence, with UNHCR, every activity includes a link back to their IATI page:
This isn’t strictly a “project document”, and might well be frowned upon by those who only expect certain codes/documents, but I think the arguments to support this would be well-received: it makes the data more useful. :
Any IATI activity could be presented in any other portal/search results - out of context from the original XML publication (and far far away from the IATI Registry). Hence, providing some link back to documentation within the activity helps people (the data users) wanting to find out more. It’s like a consistent footnote for each and every activity.
Publishers can / could be encouraged to provide details of the decisions they have made along their IATI journey in these documents. It might even help explain any particular namespaces, or hierarchies or any data behavours one should expect.
Elsewhere - when using vocabulary 99 codes, we encourage the publication of a URL to access the complete vocabulary. I see this link to documentation as a place to put this in context.
It’d be useful to hear what others think of this. Technically, this “breaks” the standard! I’ve posted elsewhere about the background the document category codes, as this might need some focus and discussion.