Merge pull request #1252 from rackerlabs/update-app-guide

docs: update information on adding and removing components

Author: nicholaskuechler

docs/deploy-guide/add-remove-app.md renamed to docs/design-guide/add-remove-app.md

@@ -4,7 +4,7 @@ UnderStack **Components** are deployed via [ArgoCD]
 as [Applications][argocd-app], these are generated using [ArgoCD][argocd]'s
 [ApplicationSet][argocd-appset] controller. This allows us to use common
 patterns to deploy each of the components and allow specific environments
-to modify or disable some components. See the [Configuring Components](./component-config.md)
+to modify or disable some components. See the [Configuring Components](../deploy-guide/component-config.md)
 guide for more info on how to do so.
 
 ## Adding a Component to UnderStack
@@ -50,12 +50,26 @@ sources:
 
 {% endraw %}
 
+### Configuring the namespace
+
+If the namespace you'll be adding the component to is currently not in
+use, you will have to add it to the appropriate AppProject for the
+ApplicationSet in one of the following:
+
+- `apps/appsets/project-understack-infra.yaml`
+- `apps/appsets/project-understack-operators.yaml`
+- `apps/appsets/project-understack.yaml`
+
 ## Removing an application from UnderStack
 
 Removing a Component permanently from UnderStack is as easy as
 deleting its YAML config from its AppSet in the `apps/<appset>/`
 directory.
 
+!!! note
+    Remove the namespace from the AppProject if it is no longer
+    in use.
+
 [argocd]: <https://argo-cd.readthedocs.io/en/stable/>
 [argocd-app]: <https://argo-cd.readthedocs.io/en/stable/user-guide/application-specification/>
 [argocd-appset]: <https://argo-cd.readthedocs.io/en/stable/operator-manual/applicationset/>

mkdocs.yml

@@ -119,6 +119,7 @@ nav:
       - component-ansible.md
   - 'Design Guide':
     - design-guide/intro.md
+    - design-guide/add-remove-app.md
     - design-guide/neutron-networking.md
     - design-guide/argo-workflows.md
     - design-guide/argo-events.md
@@ -142,7 +143,6 @@ nav:
       - deploy-guide/troubleshooting.md
     - Further Actions:
       - deploy-guide/extra-sites.md
-      - deploy-guide/add-remove-app.md
       - deploy-guide/override-openstack-svc-config.md
   - 'Operator Guide':
     - operator-guide/index.md