Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

@version attribute on iati-activity #30

Closed
Bjwebb opened this issue Oct 7, 2013 · 6 comments
Closed

@version attribute on iati-activity #30

Bjwebb opened this issue Oct 7, 2013 · 6 comments

Comments

@Bjwebb
Copy link
Contributor

Bjwebb commented Oct 7, 2013

        A number indicating the IATI specification version in use.
        Defaults to "1.0" if not specified.  It is required to
        specify this attribute if the document is using features
        specific to an IATI specification other than the initial
        1.0 version.

Should this be on both iati-activities and iati-activity. The behaviour if one is defined and the other isn't is not well defined. Moreover, it is not clear if documents with iati-activity elements with different version attributes are permitted, since the documentation says iati-activity@version refers to whether the document uses certain features.

Additionally, the documentation says that it defaults to '1.0'. This version of the schema is not available online.

@bill-anderson
Copy link
Contributor

Should be in iati-activities only. (can't see the use case for two activities in the same file employing different versions)

Documentation should say: "defaults to the current version ..."

@stevieflow
Copy link
Contributor

Is that a proposal to *remove" @Version from iati-activity? I had understood the rationale for including it was in the use case where people parse out activities (as in the datastore). In this case, how would we know what version these activity documents relate to (although granted, this is not in use currently)?

@bill-anderson
Copy link
Contributor

Yup you're right, the use case is not for loading into the data store (which can inherit from iati-activities) but in the xml blobs that can be accessed separately.What then is the point of having it in iati-activities??

@stevieflow
Copy link
Contributor

Please also note that the description text with this particular attribute is:

"A number indicating the IATI specification version in use. Defaults to "1.0" if not specified. It is required to specify this attribute if the document is using features specific to an IATI specification other than the initial 1.0 version."

Whereas for iati-activities it is just:

"A number indicating the IATI specification version in use."

@Bjwebb
Copy link
Contributor Author

Bjwebb commented Apr 9, 2014

The purpose of having @version in iati-activities is so that a data user can easily look at a file, and work out what version of the IATI Standard is needed to interpret the file. I don't think it should be possible to have activities of differing versions in a file (as this is problematic for data consumers), but this is not a constraint we currently describe anywhere.

I've written my proposal for this up on the support forum http://support.iatistandard.org/entries/50761977--version-should-be-consistent

@Bjwebb
Copy link
Contributor Author

Bjwebb commented Jul 3, 2014

This has been fixed in 2.01 by requiring both version attributes, and requiring that all versions in a file are the same:
http://support.iatistandard.org/entries/57866638-Tightening-up-on-version
#109

@Bjwebb Bjwebb closed this as completed Jul 3, 2014
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

4 participants