feat: Next steps for common use cases

ADubhlaoich · ADubhlaoich · commit 4bd66ed10358 · 2025-05-29T16:32:52.000+01:00
diff --git a/content/ngf/install/control-plane-certs.md b/content/ngf/install/control-plane-certs.md
@@ -1,23 +1,28 @@
 ---
-title: Add secure authentication to the control and data planes
-weight: 300
+title: Add certificates for secure authentication
+weight: 100
 toc: true
-type: how-to
-product: NGF
-docs: DOCS-0000
+nd-content-type: how-to
+nd-product: NGF
 ---
 
-## Overview
+By default, NGINX Gateway Fabric installs self-signed certificates to secure the connection between the NGINX Gateway Fabric control plane and the NGINX data plane pods. These certificates are created by a `cert-generator` job when NGINX Gateway Fabric is first installed. 
 
-By default, NGINX Gateway Fabric installs self-signed certificates to secure the connection between the NGINX Gateway Fabric control plane and the NGINX data plane pods. These certificates are created by a `cert-generator` job when NGINX Gateway Fabric is first installed. However, because these certificates are self-signed and will expire after 3 years, it is recommended to use a solution such as [cert-manager](https://cert-manager.io) to create and manage these certificates in a production environment.
+However, because these certificates are self-signed and will expire after 3 years, we recommend a solution such as [cert-manager](https://cert-manager.io) to create and manage these certificates in a production environment.
 
-This guide will step through how to install and use `cert-manager` to secure this connection. **This should be done _before_ you install NGINX Gateway Fabric.**
+This guide will step through how to install and use `cert-manager` to secure this connection. 
+
+{{< caution >}}
+
+These steps should be completed before you install NGINX Gateway Fabric.
+
+{{< /caution >}}
 
 ---
 
 ## Before you begin
 
-You need:
+To complete this guide, you will need the following prerequisites:
 
 - Administrator access to a Kubernetes cluster.
 - [Helm](https://helm.sh) and [kubectl](https://kubernetes.io/docs/tasks/tools/#kubectl) must be installed locally.
@@ -180,7 +185,7 @@ Specify the Secret name using the `agent-tls-secret` command-line argument.
 
 {{</tabs>}}
 
-## Final steps
+## Confirm the Secrets have been created
 
 You should see the Secrets created in the `nginx-gateway` namespace:
 
@@ -195,3 +200,9 @@ server-tls         kubernetes.io/tls   3      8s
 ```
 
 You can now [install NGINX Gateway Fabric]({{< ref "/ngf/install/" >}}).
+
+## Next steps
+
+- [Install NGINX Gateway Fabric with Helm]({{< ref "/ngf/install/helm.md" >}})
+- [Install NGINX Gateway Fabric with Manifests]({{< ref "/ngf/install/manifests.md" >}})
+- [Install NGINX Gateway Fabric with NGINX Plus]({{< ref "/ngf/install/nginx-plus.md" >}})
diff --git a/content/ngf/install/deploy-data-plane.md b/content/ngf/install/deploy-data-plane.md
@@ -1,6 +1,6 @@
 ---
 title: Deploy a Gateway for data plane instances
-weight: 500
+weight: 600
 toc: true
 type: how-to
 product: NGF
diff --git a/content/ngf/install/helm.md b/content/ngf/install/helm.md
@@ -1,9 +1,9 @@
 ---
-title: Installation with Helm
-weight: 100
+title: Install NGINX Gateway Fabric with Helm
+weight: 200
 toc: true
-type: how-to
-product: NGF
+nd-content-type: how-to
+nd-product: NGF
 docs: DOCS-1430
 ---
 
@@ -15,11 +15,11 @@ Learn how to install, upgrade, and uninstall NGINX Gateway Fabric in a Kubernete
 
 ## Before you begin
 
-To complete this guide, you'll need to install:
+To complete this guide, you will need:
 
 - [kubectl](https://kubernetes.io/docs/tasks/tools/), a command-line tool for managing Kubernetes clusters.
 - [Helm 3.0 or later](https://helm.sh/docs/intro/install/), for deploying and managing applications on Kubernetes.
-- If deploying into a production environment, we highly recommend [installing custom certificates]({{< ref "/ngf/install/control-plane-certs.md" >}}) for securing the connection between the NGINX Gateway Fabric control plane and NGINX data plane Pods. **This should be done _before_ you install NGINX Gateway Fabric.** The default certificates are self-signed and will expire after 3 years.
+- [Add certificates for secure authentication]({{< ref "/ngf/install/control-plane-certs.md" >}}) in a production environment.
 
 {{< important >}} If you’d like to use NGINX Plus, some additional setup is also required: {{</ important >}}
 
@@ -316,8 +316,6 @@ For additional information on configuring and understanding the behavior of cont
 
 {{</see-also>}}
 
----
-
 ## Uninstall NGINX Gateway Fabric
 
 Follow these steps to uninstall NGINX Gateway Fabric and Gateway API from your Kubernetes cluster:
@@ -345,8 +343,9 @@ Follow these steps to uninstall NGINX Gateway Fabric and Gateway API from your K
 
    - {{< include "/ngf/installation/uninstall-gateway-api-resources.md" >}}
 
----
+## Next steps
 
-## Additional configuration
+- [Deploy a Gateway for data plane instances]({{< ref "/ngf/install/deploy-data-plane.md" >}})
+- [Routing traffic to applications]({{< ref "/ngf/traffic-management/routing-traffic-to-your-app.md" >}})
 
 For a full list of the Helm Chart configuration parameters, read [the NGINX Gateway Fabric Helm Chart](https://github.com/nginx/nginx-gateway-fabric/blob/v{{< version-ngf >}}/charts/nginx-gateway-fabric/README.md#configuration).
diff --git a/content/ngf/install/manifests.md b/content/ngf/install/manifests.md
@@ -1,5 +1,5 @@
 ---
-title: Installation with Manifests
+title: Install NGINX Gateway Fabric with Manifests
 weight: 200
 toc: true
 type: how-to
@@ -18,7 +18,7 @@ Learn how to install, upgrade, and uninstall NGINX Gateway Fabric using Kubernet
 To complete this guide, you'll need to install:
 
 - [kubectl](https://kubernetes.io/docs/tasks/tools/), a command-line interface for managing Kubernetes clusters.
-- If deploying into a production environment, we highly recommend [installing custom certificates]({{< ref "/ngf/install/control-plane-certs.md" >}}) for securing the connection between the NGINX Gateway Fabric control plane and NGINX data plane Pods. **This should be done _before_ you install NGINX Gateway Fabric.** The default certificates are self-signed and will expire after 3 years.
+- [Add certificates for secure authentication]({{< ref "/ngf/install/control-plane-certs.md" >}}) in a production environment.
 
 {{< important >}} If you’d like to use NGINX Plus, some additional setup is also required: {{</ important >}}
 
@@ -305,3 +305,8 @@ Follow these steps to uninstall NGINX Gateway Fabric and Gateway API from your K
 1. **Remove the Gateway API resources:**
 
    - {{< include "/ngf/installation/uninstall-gateway-api-resources.md" >}}
+
+## Next steps
+
+- [Deploy a Gateway for data plane instances]({{< ref "/ngf/install/deploy-data-plane.md" >}})
+- [Routing traffic to applications]({{< ref "/ngf/traffic-management/routing-traffic-to-your-app.md" >}})
diff --git a/content/ngf/install/nginx-plus.md b/content/ngf/install/nginx-plus.md
@@ -1,5 +1,5 @@
 ---
-title: Installation with NGINX Plus
+title: Install NGINX Gateway Fabric with NGINX Plus
 weight: 300
 toc: true
 type: how-to
@@ -210,10 +210,13 @@ docker pull private-registry.nginx.com/nginx-gateway-fabric/nginx-plus:{{< versi
 
 Once you have successfully pulled the image, you can tag it as needed, then push it to a different container registry.
 
----
-
 ## Alternative installation options
 
 There are alternative ways to get an NGINX Plus image for NGINX Gateway Fabric:
 
 - [Build the Gateway Fabric image]({{< ref "/ngf/install/build-image.md">}}) describes how to use the source code with an NGINX Plus subscription certificate and key to build an image.
+
+## Next steps
+
+- [Deploy a Gateway for data plane instances]({{< ref "/ngf/install/deploy-data-plane.md" >}})
+- [Routing traffic to applications]({{< ref "/ngf/traffic-management/routing-traffic-to-your-app.md" >}})
diff --git a/content/ngf/install/upgrade-2.0.md b/content/ngf/install/upgrade-2.0.md
@@ -1,6 +1,6 @@
 ---
 title: Upgrade NGINX Gateway Fabric to version 2.x
-weight: 400
+weight: 700
 toc: true
 type: how-to
 product: NGF
