Write up versioning best practices document

[nate-double-u]

There are a couple ways to do versions using Hugo.
Write a best practices document outlining the ways that work for sites of various sizes and release frequency.

Examples of versioning schemes currently in use for CNCF sites:

• https://k8s.io
• https://www.cni.dev
• https://longhorn.io/
• https://etcd.io/docs/v3.4.0/

[nate-double-u]

I've been working on the etcd.io site and versioning came up.

For sites of this scale, I think that using a folder method of versioning works better than using a URL scheme (like Kubernetes' website does). The best example I've seen of this working is the velero site, and their implementation is fairly easy to follow.

[vijay938]

I want to work on this issue

[nate-double-u]

Hi @vijay938, thanks for the interest!

I've been doing some research and thinking on versioning, and have written up a presentation about versioning with hugo and netlify, but haven't had the opportunity to write it into a document yet.

[nate-double-u]

I've added a versioning best practices write up over it the tech docs repo: cncf/techdocs#25