Title
Add document-link to Results standard
Standard
Activity
Schema Object
o result/indicator/baseline/comment
o result/indicator/period/target/comment
o result/indicator/period/actual/comment
o result/description
o result/indicator/description
Type of Change
Change to the Schema
Issue
Currently, you can only use the narrative text elements to describe what each result and associated indicators concern. This is an issue because a) the narrative is then used as a catchall for any different purpose (not easy to search, understand, is messy etc.) b) it means copying from any documents that the project already has and pasting into the narrative which is i) extra work and ii) restrictive as it does not allow you to include rich representations such as pictures, tables etc. c) it means any links (eg to WPDx , documents etc.) will have to be written into the narrative making them difficult to follow etc. (requires tools to search for links in text) .
“Data on results cannot be used for learning or accountability without context. Just because an intervention achieved its targeted results, does not mean it will work elsewhere." https://www.bond.org.uk/resources/publishing-results-to-iati
Proposal
This proposal comes from Principles 1 and 2 discussed on thread: Results: discussion space and TAG 2016/17 path
An optional link(s) to relevant documents should be added to various parts of the results standard (for example to allow linking to context analysis that could include: any conflicts/ fragility, scope of influence, scale/ stage of initiative, external pressures/ trends etc.). These additions would be used to detail qualitative results as well as how and why the result has been achieved or not, any unanticipated results, and whether this has had a positive or negative affect on the overall project.
Add document-link element (0…*) (per iati-activity/document-link http://iatistandard.org/202/activity-standard/iati-activities/iati-activity/document-link/ ) to:
· (as justified in Principle 1)
o result/indicator/baseline/comment
o result/indicator/period/target/comment
o result/indicator/period/actual/comment
· (as justified in Principle 2)
o result/description
o result/indicator/description
Standards Day
Workshopped at the TAG 2017.
Links
Thanks for this great suggestion. This would be tremendously helpful in allowing people to share their results more transparently. As the discussions on value for money continue to gain momentum, the opportunity to flexibly share content related to those results will become ever more important. Being able to link to specific data about results, such as providing a link to specific water points in the Water Point Data Exchange would allow us and other stakeholders to efficiently and clearly share their results. The ability to link to other types of result information, such as reports or photos, would be invaluable to diverse sectors. Thank you once again for this important suggestion!
Note: This is from memory and I’ve not made an extensive check
The proposed locations at which <document-link> should be added are all narrative containers, in that they allow the specification of textual data in multiple languages through use of a <narrative> element.
At present, all narrative containers are simply containers for one or more <narrative> elements and do not have any other children. Changing this state would add some level of additional confusion to use of these containers.
As such, I’d suggest moving the proposed location at which the new elements are added up a level, as such becoming:
In terms of adding a description about the document itself, there is a separate proposal regarding this addition.
Adding example in response to Rolf Kleef ’s comment on Our shared understanding of what IATI is, and is not, to demonstrate the value of this proposal. First code block is using proposal, second without proposal where you have to embed any references to documents in the freetext - the example highlights the data quality issue; without document-link there is no standard way to link to documents in results (an IATI app would have a hard time automatically figuring out how to make a link to the relevant documents below for example).
Example using proposal:
Example before proposal (per post Results – represent more than quantitative data (included 2.03) ):
This topic has been included for consideration in the formal 2.03 proposal
There will be some consultation calls in early July for any 2.03 proposals where people would like to discuss them further - if you would like to discuss this proposal on one of the calls please ‘Like’ this IATI tech team post by end of Mon 26 June - you can do this by clicking the heart symbol to the bottom right hand side of this message.
Further details on the calls are available in the ‘How to participate’ topic.
This proposal will be discussed on a consultation call on Results - Monday 3 July, 2pm (BST), 1 hour
To join this call, use this link from your computer, tablet or smartphone https://global.gotomeeting.com/join/469747029
You can also dial in using your phone.
United Kingdom: +44 330 221 0088
United States: +1 (646) 749-3129
Access Code: 469-747-029
Please 'like' this post if you plan on joining this call (click the heart symbol to the bottom right of this message)
Notes from consultation calls w/c 3rd July
Outcome:
The proposal was reviewed by those on the call and there was no objection from the group.
It was clarified where the elements have been included in the IATI activity and organisation standard summary table.
This proposal has been been included in the 2.03 upgrade. It can be viewed in the following two Discuss posts:
Final Proposal of 2.03 Content
Final Technical Proposal for the 2.03 Upgrade
Please log in or sign up to comment.