CNCFSD-1008 Docs assessment for KEDA

[nate-double-u]

As per discussions around CNCFSD-1008, let's do a Docs Assessment to help KEDA with their website improvement project.

[tomkerkhove]

Thank you!

Relates to kedacore/governance#40

[nate-double-u]

Draft KEDA docs assessment

[tomkerkhove]

Adding @zroubalik who has ideas to improve our docs as well.

[nate-double-u]

Hi @@zroubalik, please let me know if you're not able to access the doc. I think it's set up so that signed in users can edit. (trusting security through obscurity -- if an open link becomes problematic for this draft we can change the permissions)

[zroubalik]

@nate-double-u I am able to access the doc, thanks!

What I would like to see is to change KEDA documentation https://keda.sh/docs/2.7/ to something like https://docs.keda.sh - ie basically to have a project landing page as it is now, but to have a separate page for docs. Something like https://dapr.io/ and https://docs.dapr.io/, where:

• the left hand side menu has layout similar to what we can see on Dapr docs
• where we can easily see the current docs version (and have a way how to easily switch it)

[tomkerkhove]

I love that idea to have keda.sh as a "business related page" vs docs.keda.sh which has technical docs

[thisisobate]

Sounds good to me. This would warrant creating a more detailed information on the docs' landing page since the current one looks scanty.

Regardless, will discuss more with @nate-double-u about this.
Thanks for the suggestion @zroubalik!

[nate-double-u]

Updated docs analysis PR: #215