From 194340688d3c9a00a05d75352875a563f454b91b Mon Sep 17 00:00:00 2001 From: Desmond Obisi <51109125+DesmondSanctity@users.noreply.github.com> Date: Sat, 6 May 2023 02:02:35 +0100 Subject: [PATCH] Create doc-proposal.md to capture the new doc proposal (#1379) This commit contains the addition of the markdown file for the new awx-operator doc proposal --- docs/doc-proposal.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 docs/doc-proposal.md diff --git a/docs/doc-proposal.md b/docs/doc-proposal.md new file mode 100644 index 00000000..c19ea5c6 --- /dev/null +++ b/docs/doc-proposal.md @@ -0,0 +1,29 @@ +# Docs Breakdown for AWX Operator + +## Introduction + +This table below is aimed at breaking down the ReadME documentation for Ansible AWX Operator and structure it in the way it can be moved to the Read The Docs module. + +From the ReadMe file, the documentation can be classified into six distinct segments which are: + + +- Introduction/Getting Started +- Installation +- User Guide +- Upgrade +- Uninstall +- Contributors Guide + +Using these listed segments, we can do a proper breakdown of all the topics in the ReadMe and place each one in the segment they fall into. This table is open to any form of refactoring or modifications. + +| Segments | Topics | +| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Introduction | - [Purpose](https://github.com/ansible/awx-operator#purpose) | +| Installation | - [Creating a minikube cluster for testing](https://github.com/ansible/awx-operator#creating-a-minikube-cluster-for-testing)
- [Basic Install](https://github.com/ansible/awx-operator#basic-install)
- [Helm Install on existing cluster](https://github.com/ansible/awx-operator#helm-install-on-existing-cluster) | +| User Guide | - [Admin user account configuration](https://github.com/ansible/awx-operator#admin-user-account-configuration)
- [Network and TLS Configuration](https://github.com/ansible/awx-operator#network-and-tls-configuration)
* [Service Type](https://github.com/ansible/awx-operator#service-type)
* [Ingress Type](https://github.com/ansible/awx-operator#ingress-type)
- [Database Configuration](https://github.com/ansible/awx-operator#database-configuration)
* [External PostgreSQL Service](https://github.com/ansible/awx-operator#external-postgresql-service)
* [Migrating data from an old AWX instance](https://github.com/ansible/awx-operator#migrating-data-from-an-old-awx-instance)
* [Managed PostgreSQL Service](https://github.com/ansible/awx-operator#managed-postgresql-service)
- [Advanced Configuration](https://github.com/ansible/awx-operator#advanced-configuration)
* [Deploying a specific version of AWX](https://github.com/ansible/awx-operator#deploying-a-specific-version-of-awx)
* [Redis container capabilities](https://github.com/ansible/awx-operator#redis-container-capabilities)
* [Privileged Tasks](https://github.com/ansible/awx-operator#privileged-tasks)
* [Containers Resource Requirements](https://github.com/ansible/awx-operator#containers-resource-requirements)
* [Priority Classes](https://github.com/ansible/awx-operator#priority-classes)
* [Assigning AWX pods to specific nodes](https://github.com/ansible/awx-operator#assigning-awx-pods-to-specific-nodes)
* [Trusting a Custom Certificate Authority](https://github.com/ansible/awx-operator#trusting-a-custom-certificate-authority)
* [Enabling LDAP Integration at AWX bootstrap](https://github.com/ansible/awx-operator#enabling-ldap-integration-at-awx-bootstrap)
* [Persisting Projects Directory](https://github.com/ansible/awx-operator#persisting-projects-directory)
* [Custom Volume and Volume Mount Options](https://github.com/ansible/awx-operator#custom-volume-and-volume-mount-options)
* [Default execution environments from private registries](https://github.com/ansible/awx-operator#default-execution-environments-from-private-registries)
* * [Control plane ee from private registry](https://github.com/ansible/awx-operator#control-plane-ee-from-private-registry)
* [Exporting Environment Variables to Containers](https://github.com/ansible/awx-operator#exporting-environment-variables-to-containers)
* [CSRF Cookie Secure Setting](https://github.com/ansible/awx-operator#csrf-cookie-secure-setting)
* [Session Cookie Secure Setting](https://github.com/ansible/awx-operator#session-cookie-secure-setting)
* [Extra Settings](https://github.com/ansible/awx-operator#extra-settings)
* [Configure no_log](https://github.com/ansible/awx-operator#no-log)
* [Auto Upgrade](https://github.com/ansible/awx-operator#auto-upgrade)
** [Upgrade of instances without auto upgrade](https://github.com/ansible/awx-operator#upgrade-of-instances-without-auto-upgrade)
* [Service Account](https://github.com/ansible/awx-operator#service-account)
* [Labeling operator managed objects](https://github.com/ansible/awx-operator#labeling-operator-managed-objects)
* [Pods termination grace period](https://github.com/ansible/awx-operator#pods-termination-grace-period)
* [Disable IPV6](https://github.com/ansible/awx-operator#disable-ipv6)
* [Add Execution Nodes](https://github.com/ansible/awx-operator#adding-execution-nodes)
** [Custom Receptor CA](https://github.com/ansible/awx-operator#custom-receptor-ca)
* [Debugging](https://github.com/ansible/awx-operator/blob/devel/docs/debugging.md)
* [Migration](https://github.com/ansible/awx-operator/blob/devel/docs/migration.md) | +| Upgrade | - [Upgrading](https://github.com/ansible/awx-operator#upgrading)
* [Backup](https://github.com/ansible/awx-operator#backup)
* [v0.14.0](https://github.com/ansible/awx-operator#v0140)
** [Cluster-scope to Namespace-scope considerations](https://github.com/ansible/awx-operator#cluster-scope-to-namespace-scope-considerations)
** [Project is now based on v1.x of the operator-sdk project](https://github.com/ansible/awx-operator#project-is-now-based-on-v1x-of-the-operator-sdk-project)
** [Steps to upgrade](https://github.com/ansible/awx-operator#steps-to-upgrade) | +| Uninstall | - [Uninstall](https://github.com/ansible/awx-operator#uninstall) | +| Contributors Guide | - [Contributing](https://github.com/ansible/awx-operator#contributing)
- [Release Process](https://github.com/ansible/awx-operator#release-process)
- [Author](https://github.com/ansible/awx-operator#author)
- [Code of Conduct](https://github.com/ansible/awx-operator#code-of-conduct)
- [Get Involved](https://github.com/ansible/awx-operator#get-involved) | + + +Note: I could not get the multi-level bullet point list to work in the table so I used single asterisk `*` for one level down and double asterisk `**` for two level down.