Update reference section as per #1883 (#2806)

* Update reference section as per #1883

* fix link

* update folder name

* fixed links and peer review feedback

* added aliases

* added aliases

* removed unnecessary heading

* removed kn section

* updated heading and position of optional stuff

* fix note

docs/reference/_index.md

@@ -1,8 +1,8 @@
 ---
 title: "Knative Reference Documentation"
-linkTitle: "Reference and API"
+linkTitle: "Reference"
 weight: 100
 type: "docs"
 ---
 
-Knative API and reference documentation.
+Knative reference documentation.

docs/reference/api/README.md

@@ -1,5 +1,3 @@
-# Knative API Reference documentation
-
 ## View the latest release
 
 The reference documentation for the latest release of the Knative is available
@@ -16,7 +14,7 @@ The API source files are located at:
 ## Updating API Reference docs (for Knative maintainers)
 
 The Knative API reference documentation is manually generated using the
-[`gen-api-reference-docs.sh`](../../hack/) tool. If you need to generate a new
+[`gen-api-reference-docs.sh`](../../../hack/) tool. If you need to generate a new
 version of the API docs for a recent update or for a new release, you can use
 the following steps.
 
@@ -67,7 +65,7 @@ To generate a version of the API:
 
    ```
    cd hack
-   
+
    KNATIVE_SERVING_COMMIT=[commit_or_tag] \
    KNATIVE_EVENTING_COMMIT=[commit_or_tag] \
    KNATIVE_EVENTING_CONTRIB_COMMIT=[commit_or_tag] \
@@ -94,6 +92,7 @@ about requesting changes in the `knative/docs` repo.
 
 ### Example
 
+<!--TODO: UPDATE THIS EXAMPLE VERSION-->
 To build a set of Knative API docs for v0.3, you can use the `v0.3.0` the tags
 from each of the Knative component repositories, like
 [Serving v0.3.0](https://github.com/knative/serving/tree/v0.3.0). If you want to

docs/reference/api/_index.md

@@ -0,0 +1,11 @@
+---
+title: "Knative API Reference Documentation"
+linkTitle: "API"
+weight: 100
+type: "docs"
+aliases:
+aliases:
+   - /docs/reference/
+---
+
+{{% readfile file="README.md" %}}

docs/reference/api/eventing/_index.md

@@ -1,8 +1,10 @@
 ---
 title: "Knative Eventing Component"
 linkTitle: "Eventing API"
-weight: 30
+weight: 20
 type: "docs"
+aliases:
+   - /docs/reference/eventing/eventing
 ---
 
 {{< readfile file="eventing.md" >}}

docs/reference/api/eventing/eventing-contrib-api.md

@@ -3,6 +3,8 @@ title: "Eventing-contrib Resources"
 linkTitle: "Eventing-contrib API"
 weight: 50
 type: "docs"
+aliases:
+   - /docs/reference/eventing/eventing-contrib-api
 ---
 
 {{< readfile file="eventing-contrib.md" >}}

docs/reference/api/serving-api.md

@@ -1,8 +1,10 @@
 ---
 title: "Knative Serving Component"
 linkTitle: "Serving API"
-weight: 50
+weight: 10
 type: "docs"
+aliases:
+   - /docs/reference/serving-api
 ---
 
 {{< readfile file="serving.md" >}}

docs/reference/client/README.md

@@ -1 +0,0 @@
- Knative Client, `kn`, is a command line interface (CLI) for creating and managing Knative applications from the terminal.

docs/reference/client/_index.md

@@ -1,8 +0,0 @@
----
-title: "Client (Kn)"
-linkTitle: "Client (Kn)"
-weight: 10
-type: "docs"
----
-
-{{% readfile file="README.md" %}}

docs/reference/relnotes/_index.md

@@ -0,0 +1,13 @@
+---
+title: "Knative Release Notes"
+linkTitle: "Release notes"
+weight: 10
+type: "docs"
+---
+
+For details about the Knative releases, see the following pages:
+
+- [Knative Serving releases](https://github.com/knative/serving/releases)
+- [Knative Serving Operator releases](https://github.com/knative/serving-operator/releases)
+- [Knative CLI releases](https://github.com/knative/client/releases)
+- [Knative Eventing releases](https://github.com/knative/eventing/releases)

docs/reference/resources.md

@@ -1,7 +1,9 @@
 ---
-title: "Resources"
-weight: 10
+title: "Additional resources"
+weight: 100
 type: "docs"
+aliases:
+   - /docs/concepts/resources
 ---
 
 This page contains information about various tools and technologies that are