Tech docs website best-practices: reference-implementation design & maintenance

[chalin]

Evolving, documenting and demonstrating CNCF tech-docs website best-practices through reference-implementation design & maintenance, as well as techdocs documentation.

1. Reference implementations: design and implement website infrastructure / best-practices in "reference-implementation" websites that have recently been reworked by the team:
   • etcd.io, with @nate-double-u
   • grpc.io
     2. CNCF website starter: contribute to the discussion, planning and creation of a starter, be it through either of the following:
   • hugo-netlify-starter, or
   • Our own CNCF-customized version of the docsy-example
     3. Documentation: contribute to documenting our website best-practices.
   • Related: https://github.com/cncf/techdocs/issues/54

[chalin]

Although @caniszczyk recently gave a thumbs up to using Docsy (https://github.com/cncf/hugo-netlify-starter/issues/64), as an alternative to migrating the hugo-netlify-starter to Docsy we should consider building on / customizing the docsy-example, which is already setup as a GitHub template.

I've updated the task breakdown in the original comment to reflect this possibility.

/cc @nate-double-u, since we discussed some of the details recently.