Add document-link to Results indicator (included 2.03)

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


2 Likes

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:

  • result/indicator/baseline/document-link
  • result/indicator/period/target/document-link
  • result/indicator/period/actual/document-link
  • result/document-link
  • result/indicator/document-link

In terms of adding a description about the document itself, there is a separate proposal regarding this addition.

Adding example in response to @rolfkleef’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:

<result type="2">
  <title>
    <narrative>Potential for inclusion of hygiene promotion into national vaccination programme beyond pilot project</narrative>
  </title>
  <description>
    <narrative></narrative>
  </description>
  <indicator measure="Qualitative">
    <title>
      <narrative>feasibility of integrating hygiene promotion into vaccination programme under normal programme delivery circumstances</narrative>
    </title>
    <baseline year="2014">
      <comment>
        <narrative>Scoping study in 2012 demonstrated the desire of health sector to pilot initiative through identifying missed opportunity to combine hygiene promotion into national vaccination programme – see document-link for details</narrative>
      </comment>
		  <document-link url="http://washdev.iwaponline.com/content/3/3/459" format="text/html">
			<title>
				<narrative>An opportunity not to be missed – immunisation as an entry point for hygiene promotion and diarrhoeal disease reduction in Nepal</narrative>
			</title>
			<category code="A08"></category>
		  </document-link>	
    </baseline>
    <period>
      <period-start iso-date="2014-01-01"></period-start>
      <period-end iso-date="2016-04-05"></period-end>
      <actual>
        <comment>
          <narrative> recommendations copied from the document-link:
o	Both the FCHV and health worker should be involved to run the session smoothly.
o	Some incentive for health worker to motivate them to work actively.
o	Regular supervision from district and center level for proper feedback.
o	Vaccinator should also involve in review program.
o	This program should give continuity in future and scale up in other districts also because hygiene promotion is directly/indirectly related to decrease/minimize the cases of child mortality and morbidity.
o	Number of games should be decrease so that it will takes less time to run session.</narrative>
        </comment>
			<document-link url="http%3A%2F%2F16_04_051-Nepal%20vaccines%20FCP%20narrative%20report%20template%20April%202016%20-%20March%202017_Final_13%20May%202017_A_B_Om.docx" format="application/msword">
			  <title>
				<narrative>A Report on Midterm review of Hygiene Promotion through Routine Immunization program</narrative>
			  </title>
			  <category code="A08"></category>
			</document-link>				
      </actual>
    </period>
    <period>
      <period-start iso-date="2016-04-05"></period-start>
      <period-end iso-date="2017-02-10"></period-end>
      <actual>
        <comment>
          <narrative> conclusion copied from the document-link:
            Representatives of four District/Public Health Office and FCHVs have shared that the Hygiene Promotion through Routine Immunization Programme can be implemented successfully using the existing health system. It has shown its mutual synergy to increase the positive hygiene behaviour change and increasing the coverage of routine immunization. They have also flag that the program has played a vital role in reducing the dropout and wastage rate of the vaccine. All four districts mentioned that there is no outbreak of diarrhoeal and cholera diseases in their districts after the implementation of this program.
            The integration of hygiene promotion package in Routine Immunization sessions has been well appreciated and accepted by FCHVs / health workers and the mothers. So, this review meeting has recommended for the need to continue the program in these four districts and should be scaled up in other districts.</narrative>
        </comment>
			<document-link url="https%3A%2F%2FCentral%20Level%20Review%20Meeting%20of%20%22Hygiene%20Promotion%20through%20Routine%20Immunization%20Programme%20in%20Nepal.docx" format="application/msword">
			  <title>
				<narrative>Central Level Review Meeting of "Hygiene Promotion through Routine Immunization Programme in Nepal</narrative>
			  </title>
			  <category code="A08></category>
			</document-link>			
      </actual>
    </period>
    <period>
      <period-start iso-date="2014-01-01"></period-start>
      <period-end iso-date="2017-06-01"></period-end>
      <target>
        <comment>
          <narrative>fully feasible to integrate hygiene promotion into vaccination programme under normal programme delivery circumstances.</narrative>
        </comment>
      </target>
    </period>        
  </indicator>
</result>

Example before proposal (per post Results – represent more than quantitative data (included 2.03) ):

<result type="2">
  <title>
    <narrative>Potential for inclusion of hygiene promotion into national vaccination programme beyond pilot project</narrative>
  </title>
  <description>
    <narrative></narrative>
  </description>
  <indicator measure="Qualitative">
    <title>
      <narrative>feasibility of integrating hygiene promotion into vaccination programme under normal programme delivery circumstances</narrative>
    </title>
    <baseline year="2014">
      <comment>
        <narrative>Scoping study in 2012 demonstrated the desire of health sector to pilot initiative through identifying missed opportunity to combine hygiene promotion into national vaccination programme – see published scoping document http://washdev.iwaponline.com/content/3/3/459.</narrative>
      </comment>
    </baseline>
    <period>
      <period-start iso-date="2014-01-01"></period-start>
      <period-end iso-date="2016-04-05"></period-end>
      <actual>
        <comment>
          <narrative> recommendations copied from the document 16_04_051-Nepal vaccines FCP narrative report template April 2016 - March 2017_Final_13 May 2017_A_B_Om from the activity’s document-link:
o	Both the FCHV and health worker should be involved to run the session smoothly.
o	Some incentive for health worker to motivate them to work actively.
o	Regular supervision from district and center level for proper feedback.
o	Vaccinator should also involve in review program.
o	This program should give continuity in future and scale up in other districts also because hygiene promotion is directly/indirectly related to decrease/minimize the cases of child mortality and morbidity.
o	Number of games should be decrease so that it will takes less time to run session.</narrative>
        </comment>            
      </actual>
    </period>
    <period>
      <period-start iso-date="2016-04-05"></period-start>
      <period-end iso-date="2017-02-10"></period-end>
      <actual>
        <comment>
          <narrative> conclusion copied from review meetings document with title” Central Level Review Meeting of "Hygiene Promotion through Routine Immunization Programme in Nepal" on 10th Feb, 2017”:
            Representatives of four District/Public Health Office and FCHVs have shared that the Hygiene Promotion through Routine Immunization Programme can be implemented successfully using the existing health system. It has shown its mutual synergy to increase the positive hygiene behaviour change and increasing the coverage of routine immunization. They have also flag that the program has played a vital role in reducing the dropout and wastage rate of the vaccine. All four districts mentioned that there is no outbreak of diarrhoeal and cholera diseases in their districts after the implementation of this program.
            The integration of hygiene promotion package in Routine Immunization sessions has been well appreciated and accepted by FCHVs / health workers and the mothers. So, this review meeting has recommended for the need to continue the program in these four districts and should be scaled up in other districts.</narrative>
        </comment>
      </actual>
    </period>
    <period>
      <period-start iso-date="2014-01-01"></period-start>
      <period-end iso-date="2017-06-01"></period-end>
      <target>
        <comment>
          <narrative>fully feasible to integrate hygiene promotion into vaccination programme under normal programme delivery circumstances.</narrative>
        </comment>
      </target>
    </period>        
  </indicator>
</result>

This topic has been included for consideration in the formal 2.03 proposal

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: