search

TREEcg / specification

RDF vocabulary and hypermedia specification to publish your Linked Data using search trees
https://w3id.org/tree/specification
29 stars 13 forks source link

Add Version control #84

Closed xdxxxdx closed 7 months ago

xdxxxdx commented 1 year ago

As the GitHub - Informatievlaanderen/VSDS-Testbed is developed for testing against The TREE hypermedia specification. It might be a good idea to have version control of the SPEC (includes historical versions), then the testbed could always have a valid reference link pointing to the SPEC.

Also projects developed for implementing TREE also can benefit from it, when using dct:conforms in the metadata.

kkostov commented 1 year ago

This would be very helpful indeed!

pietercolpaert commented 1 year ago

Good point. We should also raise this during tomorrow’s call!

pietercolpaert commented 1 year ago

From the call decision:

Let’s add a semantic version changelog, but let’s indicate that our goal is to have no breaking changes: we are working towards a 1.0 version that must remain backwards compatible forever

pietercolpaert commented 7 months ago

As this is still not fully in place, I’d like to propose a change: the W3C specifications usually work with changelogs based on decisions that were taken, and with a version of a spec based on a certain data of the latest consensus.

I’d propose using the releases functionality on Github for listing the decisions that have been taken and the time of that meeting.

pietercolpaert commented 7 months ago

As this was discussed in the standardization call: we’ll go with time-based spec versions instead of semantic versioning.