Version 2.03 Available for Inspection and Testing

The IATI Technical Team is pleased to announce that the IATI Standard Version 2.03 Schema is now available for inspection and testing. The full schema can be found on GitHub

What does this mean?

All additions which were proposed and accepted during the 2.03 upgrade period have been added into the three IATI Schemas: Activities, Organisations and Common, as well as the Codelists and Rulesets. Together these make up the IATI Standard. This has involved editing the xml and testing that from a technical point of view all of the proposals work and, where possible, are consistent with the current IATI Standard.

You can look on github to see how the proposals have been implemented.

Please see the section below for details on how to comment on the v2.03 IATI schema.

When can I start using v2.03?

Version 2.03 of the IATI website will go live by the 19th Feb 2018. This will include guidance on how to implement the new additions as well as a full change log. We will also have updated the IATI Public Validator so that you can check your version 2.03 IATI files. At this point you can publish your version 2.03 file/s.

The different publishing tool and service providers will be working to update their products to version 2.03. Please look out for communications from them about when this will be ready for you to use.


How do I comment on the v2.03 schema?

The changes made across the v2.03 schema can be found in the following branches on github:

1.https://github.com/IATI/IATI-Schemas/tree/version-2.03dev

2.https://github.com/IATI/IATI-Codelists/tree/version-2.03dev

3.https://github.com/IATI/IATI-Codelists-Nonembedded/tree/version-2.03dev

4.https://github.com/IATI/IATI-Rulesets/tree/version-2.03dev

‘*’ Comments are welcome using the above ‘comments’ links where members of the community identify that technical implementation is incorrect (given the final technical proposal)

Improvements to the process used to develop the v2.03 schemas

The development process for the schemas has been enhanced in this upgrade through a thorough TDD (test-driven development) approach, with a schema test runner built using schema validation functionality in pyIATI. Additionally, various elements of the schemas have been reorganised to improve adherence to software development best practices.

2 Likes

Great. I am unable to find a changelog comparing branches 2.02 and version-2.03dev. We could do it ourselves, but is this supplied anywhere, so we can all look at the same document of changes? Thanks.

1 Like

tl;dr: +1 to Siem’s comment. What’s the best way for the IATI community to do a final review of these changes?


@siemvaessen the version-2.03 branch is currently a copy of version-2.02 (more or less. It has one commit, but that’s mostly whitespace fixes.) So I think the diff of version-2.03dev with version-2.03 (linked above) is the thing you’re after.

That said, it looks like there’s quite a lot of schema test runner-related stuff in that diff now, which adds a lot of noise… Perhaps It would be easier to exclude that? (e.g. by merging it into version-2.02 as well).

Well, I understand, but could an IATI tech teammember please do that and publish that? This will ensure we are all on the same pages, rather than developers checking the differences in between branches… Pretty sure anyone non technical is now unable to check the difference.

1 Like

Sorry yeah – I was agreeing with you, Siem.

And when I say “Perhaps It would be easier to exclude [schema test runner-related stuff]”, that was intended to be directed at @IATI-techteam.

1 Like

Agree we need to include a changelog for developers with the release candidate. Will happen next time around.

1 Like

This is a valid point @siemvaessen and @andylolz. For future upgrade schema releases we would consider adding a changelog.rst file for all of the SSOT repositories (Schemas, Codelists and Rulesets) with pull request numbers to each line, so that it is easier for developers to track the changes.

At the moment you can view the changes from 2.02 to 2.03 in:

1 Like

Those diffs don’t exclude other changes, so they struggle to render on old computers (like mine). These are a bit better (and exclude whitespace changes):

[UPDATE: it turns out this is specifically a Chrome/OSX issue. Those big diffs render nicely elsewhere.]

Regarding changelog - am I right to assume that something along the lines of all other updates being prepared - as in http://iatistandard.org/202/upgrades/decimal-upgrade-to-2-02/2-02-changes/ ?

With all the documentation changes needed - when would a dev version of the 2.03 IATI standard site be available?

Given that I understand 2.03 will be going live on Monday 19th Feb, then I guess we won’t see this @IATI-techteam?

http://dev.iatistandard.org/203/ is the dev site. This was last generated around 6 hours ago.

It currently has a few issues around Examples, Codelists and Rules, though the fixes for these are known / in-progress / complete and waiting for deployment.

1 Like

ok thanks @hayfield

I guess this now does that: http://dev.iatistandard.org/203/upgrades/decimal-upgrade-to-2-03/2-03-changes/ ?

Note: if this site was also generated at the same time as original notice, it would have been really helpful to point us to it.

1 Like

Yes, this is very much a changelog. Fabulous.

We are pleased to announce that as of Mon 19th February version 2.03 of the IATI Standard is live.

Read more details here: https://www.aidtransparency.net/news/iati-upgrade-to-version-2-03-goes-live

Thank you to all of you who have contributed to in the upgrade discussions, submitting proposals and testing. If you do have further comments please do let us know at: support@iatistandard.org

1 Like

Hi tech team, what are the bottom line criteria in relation to declaring 2.03 as versions in your xml.
Just used the validator on a sample of our publication with a declared version of 2.03 and it was accepted as a sound xml and as a validated xml against 2.03.
Is it than responsible to declare 2.03? @Herman @rolfkleef are you planning to offer access to your validator?

@stolk 2.03 is backwards compatible. So a valid 2.x file which says 2.03 at the top will validate.

The IATI Public Validtor is also set up to check against all of the additions included in 2.03.

Thanks Amy ! this is clear now.
greetings

@stolk Yes we are, but since the current version is an early alpha version yet, granting access will take some time. @rolfkleef is now working on getting all IATI files preprocessed at a daily basis, so that the API will have a good performace and will be scalable (even when processing larger volumes).