decentralized-identity / trustdidweb

Trust DID Web (did:tdw)
https://identity.foundation/trustdidweb/
Other
25 stars 10 forks source link

Add the rendering of older specification version #119

Open bj-ms opened 3 days ago

bj-ms commented 3 days ago

It would be great to add the rendering of previous versions of the specification like Presentation Exchange does: https://identity.foundation/presentation-exchange/

It allows to link back to older versions of the specification without having to guess the older content from the changelog chapter or render it yourself from older commits.

It will be important for interoperability later on and can help to differentiate the current implementations of did:tdw.

swcurran commented 2 days ago

I’ve done this for [mkdocs material] website, but this is not currently supported for Spec-Up — the tool we’re using to generate the website. I’ve put in a Spec-Up issue to see if a similar approach can be taken, but I’m not overly hopeful.

I’m going to see if we can make a fork of this repo and publish the v0.3 spec from the fork. Not very scalable, but I guess it would do...

swcurran commented 2 days ago

I saw able to create a fork, a branch in that fork, and use that to publish the v0.3 spec to:

https://identity.foundation/trustdidweb-v03.

I'll add a link to the version.md file to the rendered version of the spec.

I'm also going to try limit who can do what on the fork -- it's a messy path if we start making changes to it.

Hopefully we don't have to do this too often, but for now we have an approach.

swcurran commented 2 days ago

Learned about the right way to do this. Spec-Up supports multiple specs from a single base by having the "main" spec (current), and snapshots of the spec content for each version. I'll implement that in the next couple of days.