Bug 37715 - Specification should be properly versioned
Specification should be properly versioned
Product: OpenRaster
Classification: Unclassified
Component: Specification
Other All
: medium normal
Assigned To: Andrew Chadwick
Depends on:
Blocks: 37461 37717
  Show dependency treegraph
Reported: 2011-05-29 07:32 UTC by Jon Nordby
Modified: 2014-02-05 00:57 UTC (History)
0 users

See Also:
i915 platform:
i915 features:


Note You need to log in before you can comment on or make changes to this bug.
Description Jon Nordby 2011-05-29 07:32:26 UTC
Right now, there is no versioning of the OpenRaster standard. The wiki keeps track of the revisions, but additions and changes are done without nothing in the document itself when the change or addition was done.
Comment 1 Jon Nordby 2011-05-29 07:34:10 UTC
Proposed resolution is to move the spec to a git repository under https://gitorious.org/openraster and change from wiki-format to something that can be built into HTML/PDF et.c.
Comment 2 Andrew Chadwick 2012-03-24 11:54:39 UTC
Keeping track of revisions and contributions using wiki-software provided versioning and usernames should be considered actively harmful to the health of the specification. Case in point: the wiki home of the spec has moved recently, and revision history has been lost. Sorry about that. I tried to annotate in places, but a lot was lost to moves back in the CREATE wiki days :(

During my importing of the old CREATE wiki stuff, I namespaced the specification-type information under  http://www.freedesktop.org/wiki/Specifications/OpenRaster/Draft considering that it might be used as a place for drafting and refining the "next version" of the spec ... whatever that means. We could get more formal than this by either creating a Specifications/OpenRaster/<version> set of pages for each bump as some projects do, or by working on it in git as you suggest. Technically I'd be happy to do either, but IMO we should use the wiki we have at first until the draft is ready for a formal version number. It isn't right now; there are several omissions and some core pages are still a bit of mish-mash of normative stuff and un-thought-through proposals.

Hopefully we can get a minimal 0.1 created sometime soon. 1.0 before the end of the year? :D
Comment 3 Andrew Chadwick 2012-03-29 13:53:15 UTC
Addressing this via discussion on the CREATE mailing list and http://www.freedesktop.org/wiki/Specifications/OpenRaster/Draft/VersionNumber
Comment 4 Andrew Chadwick 2014-02-05 00:57:54 UTC
Now incorporated into the stack.xml spec.