Host previous drafts (at least Draft 4)

[webron]

In the OpenAPI/Swagger 2.0 spec, we had pointed to specific sections of the draft 4 documentation for further information. Our mistake was that we pointed directly to the latest documentation, but I do not think that there was an option to point it to draft-4 at the time.

With the push of the latest draft (congrats!) and the replacement of the doc, our current links are all broken. We cannot simply point to the latest version because the spec does not support it.

I'm hoping you'd be willing to consider re-hosting the previous version (draft 4) at least by allowing us to link to the right sections. I do not expect that you provide direct navigation links to it, however you may want to consider a 'previous versions' section.

As a follow-up suggestion, would also suggest providing an alias link with the current draft name and not just the 'latest' to avoid future breakage as well.

[handrews]

See also #54

[Relequestual]

@webron Sounds totally reasonable and I agree!
Apologies for the long delay in reply! I think @handrews is right, this should be part of #54 .

[webron]

@Relequestual thanks. I understand you're looking for PRs on this. I imagine the draft 4 versions are in the history, so maybe I could pick those up and prepare something.

[handrews]

@webron the previous drafts are already pulled out in folders. I think we just need to link to them.

[webron]

Maybe I'm missing something but the content of the draft-xx folders is json schemas and the html version of the spec as in latest.

[handrews]

@webron Oh you mean the HTML specification, sorry, I was thinking meta-schema (probably because I've been working on that recently). Yeah, there are some XML files in the top directory, but not all, and no generated HTML. I think we would need to generate the HTML and text forms and check them in as well since I don't think we can do that sort of dynamic thing for the web site deployment.

[webron]

For draft-4 at least, we only need to pull out https://github.com/json-schema-org/json-schema-org.github.io/tree/070e1747fbadf3e94809e5dab3e987dacbc2672a/latest and put those in the right folder.

[Relequestual]

Sorry, I did think it would be the HTML, hence not just moving files to the right folders.
@webron Right, looking for PR on this one. I believe you are right! Feel free!

(On an aside... probably steer clear of draft-5 ahem. Hop over to irc and PM me if you want to chat more.)

[webron]

@Relequestual - thanks, will try to get to it in the next few days. Hopped on IRC, will idle there.

[handrews]

Note that @agebhar1 also requested Draft 3 in json-schema-org/json-schema-spec#205