From 0c0a4987261ced7ec7fec5e5ecf2d6236efe2c50 Mon Sep 17 00:00:00 2001
From: jillianwilson <jillian.morgan@agilebits.com>
Date: Wed, 12 Jul 2023 16:02:26 -0300
Subject: [PATCH] Making changes based on PR suggestions

---
 README.md     |  8 ++++----
 USAGEGUIDE.md | 23 ++++++++++++-----------
 2 files changed, 16 insertions(+), 15 deletions(-)

diff --git a/README.md b/README.md
index d1700a3..6562506 100644
--- a/README.md
+++ b/README.md
@@ -3,7 +3,7 @@
 
 <div align="center">
   <h1>1Password Connect Kubernetes Operator</h1>
-  <p>Integrate 1Password Connect with your Kubernetes Infrastructure</p>
+  <p>Integrate <a href="https://developer.1password.com/docs/connect">1Password Connect</a> with your Kubernetes Infrastructure</p>
   <a href="https://github.com/1Password/onepassword-operator#getstarted">
     <img alt="Get started" src="https://user-images.githubusercontent.com/45081667/226940040-16d3684b-60f4-4d95-adb2-5757a8f1bc15.png" height="37"/>
   </a>
@@ -15,7 +15,7 @@ The 1Password Connect Kubernetes Operator provides the ability to integrate Kube
 
 ## ✨ Get started
 
-<h3>🚀 Quickstart</h3>
+## 🚀 Quickstart
 
 1. Add the [1Passsword Helm Chart](https://github.com/1Password/connect-helm-charts) to your repository.
 
@@ -42,8 +42,8 @@ Check that the Kubernetes Secret has been generated:
 kubectl get secret <secret_name>
 ```
 
-<h3>📄 Usage</h3>
-Refer to the [Usage Guide](https://github.com/1Password/onepassword-operator/blob/main/USAGEGUIDE.md) for documentation on how to deploy and use the 1Password Operator.
+### 📄 Usage
+Refer to the [Usage Guide](USAGEGUIDE.md) for documentation on how to deploy and use the 1Password Operator.
 
 ## 💙 Community & Support
 
diff --git a/USAGEGUIDE.md b/USAGEGUIDE.md
index 71ee0f8..eb34950 100644
--- a/USAGEGUIDE.md
+++ b/USAGEGUIDE.md
@@ -2,7 +2,8 @@
 <div align="center">
   <h1>Usage Guide</h1>
 </div>
-<h2>Table of Contents</h2>
+
+## Table of Contents
 
 - [Prerequisites](#prerequisites)
 - [Quickstart for Deploying 1Password Connect to Kubernetes](#quickstart-for-deploying-1password-connect-to-kubernetes)
@@ -12,7 +13,7 @@
 - [Development](#development)
 - [Security](#security)
 
-<h2> Prerequisites </h2>
+## Prerequisites
 
 - [1Password Command Line Tool Installed](https://1password.com/downloads/command-line/)
 - [`kubectl` installed](https://kubernetes.io/docs/tasks/tools/install-kubectl/)
@@ -20,7 +21,7 @@
 - [Generated a 1password-credentials.json file and issued a 1Password Connect API Token for the K8s Operator integration](https://developer.1password.com/docs/connect/get-started/#step-1-set-up-a-secrets-automation-workflow)
 - [A `1password-credentials.json` file generated and a 1Password Connect API Token issues for the K8s Operator integration](https://developer.1password.com/docs/connect/get-started/#step-1-set-up-a-secrets-automation-workflow)
 
-<h3>Deploying 1Password Connect to Kubernetes </h3>
+## Deploying 1Password Connect to Kubernetes
 
 If 1Password Connect is already running, you can skip this step.
 
@@ -29,13 +30,13 @@ There are options to deploy 1Password Connect:
 - [Deploy with Helm](#deploy-with-helm)
 - [Deploy using the Connect Operator](#deploy-using-the-connect-operator)
 
-<h4> Deploy with Helm </h4>
+### Deploy with Helm
 
 The 1Password Connect Helm Chart helps to simplify the deployment of 1Password Connect and the 1Password Connect Kubernetes Operator to Kubernetes.
 
 [The 1Password Connect Helm Chart can be found here.](https://github.com/1Password/connect-helm-charts)
 
-<h4> Deploy using the Connect Operator </h4>
+### Deploy using the Connect Operator
 
 This guide will provide a quickstart option for deploying a default configuration of 1Password Connect via starting the deploying the 1Password Connect Operator, however, it is recommended that you instead deploy your own manifest file if customization of the 1Password Connect deployment is desired.
 
@@ -61,9 +62,9 @@ Add the following environment variable to the onepassword-connect-operator conta
 
 Adding this environment variable will have the operator automatically deploy a default configuration of 1Password Connect to the current namespace.
 
-<h3> Kubernetes Operator Deployment </h3>
+### Kubernetes Operator Deployment
 
-<h4>Create Kubernetes Secret for OP_CONNECT_TOKEN </h4>
+#### Create Kubernetes Secret for OP_CONNECT_TOKEN ####
 
 Create a Connect token for the operator and save it as a Kubernetes Secret:
 
@@ -165,7 +166,7 @@ Titles and field names that include white space and other characters that are no
 
 ---
 
-<h2>Configuring Automatic Rolling Restarts of Deployments </h2>
+## Configuring Automatic Rolling Restarts of Deployments
 
 If a 1Password Item that is linked to a Kubernetes Secret is updated, any deployments configured to `auto-restart` AND are using that secret will be given a rolling restart the next time 1Password Connect is polled for updates.
 
@@ -255,14 +256,14 @@ make undeploy
 
 ## Development
 
-<h3> How it works </h3>
+### How it works
 
 This project aims to follow the Kubernetes [Operator pattern](https://kubernetes.io/docs/concepts/extend-kubernetes/operator/)
 
 It uses [Controllers](https://kubernetes.io/docs/concepts/architecture/controller/)
 which provides a reconcile function responsible for synchronizing resources until the desired state is reached on the cluster
 
-<h3> Test It Out </h3>
+### Test It Out
 
 1. Install the CRDs into the cluster:
 
@@ -278,7 +279,7 @@ make run
 
 **NOTE:** You can also run this in one step by running: `make install run`
 
-<h3> Modifying the API definitions</h3>
+### Modifying the API definitions
 
 If you are editing the API definitions, generate the manifests such as CRs or CRDs using: