Merge pull request #72 from f5devcentral/buufeedback

closes #71

docs/solutions/delivery/application_delivery_controller/nginx/kic/lab01.rst

@@ -1,12 +1,17 @@
 NGINX Kubernetes Ingress Controller | Deployment
 ------------------------------------------------
 
+|image00|
+
+With the infrastructure in place to support the solution, the NGINX Kubernetes Ingress Controller deployment can begin.
+
+What is NGINX Kubernetes Ingress Controller?
+
 NGINX Ingress Controller provides a robust feature set to secure, strengthen, and scale containerized apps, including:
 
 - Advanced app centric configuration - Use role-based access control (RBAC) and self service to set up security guardrails (not gates), so teams can manage their apps securely and with agility. Enable multi tenancy, reusability, simpler configs, and more.
 - Visibility and performance monitoring - Pinpoint undesirable behaviors and performance bottlenecks to simplify troubleshooting and make fixes faster.
 
-|image00|
 
 1. Change the directory into the NGINX Ingress cloned repository.
 
@@ -235,6 +240,7 @@ NGINX Ingress Controller provides a robust feature set to secure, strengthen, an
 .. |image19| image:: images/image19.png
 .. |image20| image:: images/image20.png
 .. |image21| image:: images/image21.png
+  :width: 50%
 .. |image23| image:: images/image23.png
 .. |image24| image:: images/image24.png
 .. |image26| image:: images/image26.png

docs/solutions/delivery/application_delivery_controller/nginx/kic/labSetupAWS.rst

@@ -1,6 +1,10 @@
 NGINX Kubernetes Ingress Controller | AWS Environment
 -----------------------------------------------------
 
+This solution will use AWS backend services to host the modern application and NGINX Kubernetes Ingress Controller. Utilizing AWS managed services will dramatically reduce the amount of time needed to build out a solution. Using Terraform for building the AWS services provides a consistent deployment every time.
+
+Prior knowledge of AWS or Terraform is not needed. The solution aims for a smaller learning curve on infrastructure (with abstractions) in exchange for more time with Kubernetes.
+
 Terraform_ is an open-source infrastructure as code software tool that provides a consistent CLI workflow to manage hundreds of cloud services. Terraform codifies cloud APIs into declarative configuration files.
 
 `Visual Studio Code`_ is a streamlined code editor with support for development operations like debugging, task running, and version control.
@@ -69,7 +73,10 @@ This solution is leveraging Terraform to create and manage the following product
    .. code-block::
 
       git clone https://github.com/f5devcentral/f5-digital-customer-engagement-center
-      git clone https://github.com/nginxinc/kubernetes-ingress
+
+   .. code-block::
+
+      git clone -b 'v1.10.0' --single-branch https://github.com/nginxinc/kubernetes-ingress
 
    Example:
 
@@ -115,6 +122,9 @@ This solution is leveraging Terraform to create and manage the following product
    .. code-block::
 
       cp admin.auto.tfvars.example admin.auto.tfvars
+
+   .. code-block::
+
       sudo vi admin.auto.tfvars
 
    ============== ===========================================================

docs/solutions/delivery/application_delivery_controller/nginx/kic/nginx_kic_index.rst

@@ -1,19 +1,21 @@
-Nginx - Kubernetes Ingress Controller
--------------------------------------
+NGINX Kubernetes Ingress Controller
+-----------------------------------
 
-NGINX Ingress Controller provides a robust feature set to secure, strengthen, and scale containerized apps, including:
+|image00|
 
-- Advanced app centric configuration - Use role-based access control (RBAC) and self-service to set up security guardrails (not gates), so teams can manage their apps securely and with agility. Enable multi-tenancy, reusability, simpler configs, and more.
-- Visibility and performance monitoring - Pinpoint undesirable behaviors and performance bottlenecks to simplify troubleshooting and make fixes faster.
+This solution is designed to share the experience of deploying a modern application along with the NGINX Kubernetes Ingress Controller. Throughout the solution are steps and notes highlighting the procedure to create a successful deployment. Examples at the end of the solution are in place to share current relevant deployment styles for todays applications.
 
-|image00|
+NGINX Kubernetes Ingress Controller solution can run on multiple clouds. The documents below have an order of operation to deploy the solution thoroughly. Each document, however, could be used independently with an existing environment.
+
+.. warning:: Choose the cloud provider environment listed below to start the solution. Example: **NGINX Kubernetes Ingress Controller | AWS Environment**
 
 .. |image00| image:: images/image00.png
-  :width: 50%
+  :width: 75%
   :align: middle
 
 .. toctree::
    :maxdepth: 1
    :glob:
 
+   labSetup*
    lab*

docs/usage/f5_udf_course.rst

@@ -73,7 +73,7 @@ The following steps will log you into the course:
 
    |image08|
 
-12. Access into the UDF environment is complete. Please follow the workshop-specific documentation located on the Course Description.
+12. Access into the UDF environment is complete. Please follow the workshop-specific documentation located on the Course Overview.