Restructure Docs

[buildbricks]

Fixes #
Issue 381

Proposed Changes

• Changes in docs architecture for greater accessibility
• Updated information
• Small grammatical changes

[buildbricks]

/assign @navidshaikh

[maximilien]

Generally looks good to me. Let's give this until Monday so others have time to chime in.

Also, I have a couple of PRs pending adding docs for config #411 and plugins #320. There are some pending comments. Please chime in as well since depending on order of which gets merged you or I may have to rebase. Should not be too hard either way but still stuff todo :)

Thanks for your contribution @joaedwar

[navidshaikh]

LGTM, there are few TODOs which we can fill in subsequent PRs. As there are other docs PR open, would like to get this structure merged and have other PRs follow it.

[rhuss]

Looks good to me, and we can refine it later again, too.

/lgtm

[knative-prow-robot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: joaedwar, navidshaikh, rhuss

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

• OWNERS [navidshaikh,rhuss]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment