Cleans-Up Docs

danehans · danehans · commit 7c87b0faa190 · 2022-11-04T08:50:51.000-07:00
Signed-off-by: danehans &lt;daneyonhansen@gmail.com&gt;
diff --git a/docs/latest/about_docs.rst b/docs/latest/about_docs.rst
@@ -1,4 +1,4 @@
-About the documentation
+About the Documentation
 =======================
 
 Learn how to contribute to Envoy Gateway documentation.
diff --git a/docs/latest/get_involved.rst b/docs/latest/get_involved.rst
@@ -1,4 +1,4 @@
-Getting involved
+Getting Involved
 ================
 
 We welcome contributions from the community. Please carefully review the
diff --git a/docs/latest/index.rst b/docs/latest/index.rst
@@ -1,24 +1,19 @@
 `Envoy Gateway </>`_
 =============
 
-Release |version|
+Release: |version|
 
 .. image:: https://img.shields.io/badge/slack-join-orange.svg
     :target: https://envoyproxy.slack.com/archives/C03E6NHLESV
     :alt: Join the Envoy Slack
 
-Envoy Gateway is an open source project for managing Envoy Proxy as a
-standalone or Kubernetes-based application gateway.
-
-.. note::
-
-   This project is under active development. Many, many features are not
-   complete. We would love for you to :doc:`get involved<get_involved>`.
+Envoy Gateway is an open source project for managing `Envoy Proxy`_ as a standalone or Kubernetes-based application
+gateway. `Gateway API`_ resources are used to dynamically provision and configure the managed Envoy Proxies. Whether
+you are interested in using or contributing to Envoy Gateway, the following resources will help you get started:
 
 .. toctree::
   :maxdepth: 1
 
-  intro/index
   intro/compatibility
   user_docs
   design_docs
@@ -27,3 +22,11 @@ standalone or Kubernetes-based application gateway.
   roadmap
   about_docs
   get_involved
+
+.. note::
+
+   This project is under active development. Many, many features are not
+   complete. We would love for you to :doc:`get involved<get_involved>`.
+
+.. _Envoy Proxy: https://www.envoyproxy.io/
+.. _Gateway API: https://gateway-api.sigs.k8s.io/
diff --git a/docs/latest/intro/index.rst b/docs/latest/intro/index.rst
diff --git a/docs/latest/user_docs.rst b/docs/latest/user_docs.rst
@@ -4,7 +4,7 @@ User Guides
 Learn how to deploy, use, and operate Envoy Gateway.
 
 .. toctree::
-  :maxdepth: 2
+  :maxdepth: 1
 
   user/quickstart
   user/http-routing
diff --git a/docs/v0.2.0/about_docs.rst b/docs/v0.2.0/about_docs.rst
@@ -1,4 +1,4 @@
-About the documentation
+About the Documentation
 =======================
 
 Learn how to contribute to Envoy Gateway documentation.
diff --git a/docs/v0.2.0/get_involved.rst b/docs/v0.2.0/get_involved.rst
@@ -1,4 +1,4 @@
-Getting involved
+Getting Involved
 ================
 
 We welcome contributions from the community. Please carefully review the
diff --git a/docs/v0.2.0/index.rst b/docs/v0.2.0/index.rst
@@ -1,24 +1,19 @@
 `Envoy Gateway </>`_
 =============
 
-Release |version|
+Release: |version|
 
 .. image:: https://img.shields.io/badge/slack-join-orange.svg
     :target: https://envoyproxy.slack.com/archives/C03E6NHLESV
     :alt: Join the Envoy Slack
 
-Envoy Gateway is an open source project for managing Envoy Proxy as a
-standalone or Kubernetes-based application gateway.
-
-.. note::
-
-   This project is under active development. Many, many features are not
-   complete. We would love for you to :doc:`get involved<get_involved>`.
+Envoy Gateway is an open source project for managing `Envoy Proxy`_ as a standalone or Kubernetes-based application
+gateway. `Gateway API`_ resources are used to dynamically provision and configure the managed Envoy Proxies. Whether
+you are interested in using or contributing to Envoy Gateway, the following resources will help you get started:
 
 .. toctree::
   :maxdepth: 1
 
-  intro/index
   intro/compatibility
   user_docs
   design_docs
@@ -27,3 +22,11 @@ standalone or Kubernetes-based application gateway.
   roadmap
   about_docs
   get_involved
+
+.. note::
+
+   This project is under active development. Many, many features are not
+   complete. We would love for you to :doc:`get involved<get_involved>`.
+
+.. _Envoy Proxy: https://www.envoyproxy.io/
+.. _Gateway API: https://gateway-api.sigs.k8s.io/
diff --git a/docs/v0.2.0/intro/index.rst b/docs/v0.2.0/intro/index.rst
diff --git a/docs/v0.2.0/user_docs.rst b/docs/v0.2.0/user_docs.rst
@@ -4,7 +4,7 @@ User Guides
 Learn how to deploy, use, and operate Envoy Gateway.
 
 .. toctree::
-  :maxdepth: 2
+  :maxdepth: 1
 
   user/quickstart
   user/http-routing

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-About the documentation`
	`1`	`+About the Documentation`
`2`	`2`	`=======================`
`3`	`3`
`4`	`4`	`Learn how to contribute to Envoy Gateway documentation.`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-Getting involved`
	`1`	`+Getting Involved`
`2`	`2`	`================`
`3`	`3`
`4`	`4`	`We welcome contributions from the community. Please carefully review the`