Tidy up, make it easier for users.

docs/Admin/Virtualisation/rados-gw-in-k8s.md

@@ -50,7 +50,7 @@ These steps ensure that a Ceph Pool is created with appropriate Replication.
   * Check with: `ceph osd pool application get default.rgw.buckets.index`
 
 * Create a user for the RADOS Gateway:
-  ```
+  ```bash
   ceph auth get-or-create client.rgw.k8s.svc \
       mon 'allow r' \
       osd 'allow rwx pool=default.rgw.buckets.data, allow rwx pool=default.rgw.buckets.index, allow rwx pool=.rgw.root, allow rwx pool=default.rgw.meta, allow rwx pool=default.rgw.log, allow rwx pool=default.rgw.control' \
@@ -72,13 +72,13 @@ These steps ensure that a Ceph Pool is created with appropriate Replication.
 
 * Create Secret manifests for deployment to K8s:
 
-  ```
+  ```bash
   kubectl create secret generic ceph-config \
     --namespace=object-store \
     --from-file=ceph.conf=./conf \
     --dry-run=client -o yaml > ceph-config-secret.yaml
   ```
-  ```
+  ```bash
   kubectl create secret generic ceph-keyring \
     --namespace=object-store \
     --from-file=keyring=./keyring \
@@ -95,7 +95,7 @@ These steps ensure that a Ceph Pool is created with appropriate Replication.
 
 #### Namespace
 
-```
+```yaml
 apiVersion: v1
 kind: Namespace
 metadata:
@@ -103,7 +103,7 @@ metadata:
 ```
 
 #### Service
-```
+```yaml
 apiVersion: v1
 kind: Service
 metadata:
@@ -126,7 +126,7 @@ spec:
 ```
 
 #### Deployment
-```
+```yaml
 apiVersion: apps/v1
 kind: Deployment
 metadata:
@@ -263,7 +263,7 @@ spec:
 
 Deploy this in the namespace of the appliation requiring the S3 API Access
 
-```sh
+```bash
 kubectl create secret generic s3-credentials \
   --namespace={application-namespace} \
   --from-literal=S3_ACCESS_KEY={access-key-from-user-creation} \

docs/User/Account/reset-password.md

@@ -0,0 +1,3 @@
+# Password Reset
+
+This documentation is not written yet.

docs/User/index.md

@@ -1,3 +1,10 @@
 # User
 
-This group contains documentation aimed at end-users.
+This group contains documentation aimed at end-users.
+
+## Helpful Links
+ - [Account Management](https://fjla.uk)
+ - [Password Reset](https://fjla.uk/reset)
+
+## Help Documents
+ - [How do I reset my password?](Account/reset-password.md)

docs/index.md

@@ -4,4 +4,4 @@ This site provides user documentation, technical documentation, configuration st
 
 If you are a user seeking help [click here](User/index.md).
 
-If you are an administrator seeking configuration reference [click here](Admin/index.md).
+You can use the menu to navigate through help documents and guides.

mkdocs.yaml

@@ -1,14 +1,14 @@
 site_name: FJLA Documentation
 nav:
 - Home: index.md
-- User: index.md
+- User:
+  - Account:
+    - Reset or Change Password: User/Account/reset-password.md
 - Admin:
+  - About: Admin/index.md
   - Virtualisation & Orchestration:
     - Combining K8s, PVE & Ceph: Admin/Virtualisation/pve-k8s-ceph-config.md
     - Deploy RADOS Gateway in K8s: Admin/Virtualisation/rados-gw-in-k8s.md
 
 theme:
-  name: mkdocs
+  name: material
-  color_mode: auto
-  user_color_mode_toggle: true
-  navigation_depth: 2

requirements.txt

@@ -1 +1,2 @@
-mkdocs
+mkdocs
+mkdocs-material