Feat/isd 3149/adding how to landing page (#536)

* feat/ISD-3149: Adding the initial how-to landing page. It's still yet to be properly organized

* feat/ISD-3149: Changing the organization of the how-to landing page, fix ordering of index.md accordingly

* Update docs/changelog.md

---------

Co-authored-by: Christopher Bartz <[email protected]>

Author: DeeKay3

docs/changelog.md

@@ -1,6 +1,10 @@
 # Changelog
 
-### 20250-04-15
+### 2025-04-22
+
+- Add how-to landing page.
+
+### 2025-04-15
 
 - Fix a race condition where keypairs were being deleted even though the server was being built, potentially killing active github action runs.
 

docs/how-to/index.md

@@ -0,0 +1,33 @@
+# How-to guides
+
+The following guides cover key processes and common tasks for managing
+and using the Github Runner charm.
+
+## Initial setup
+* [Change repository or organization]
+* [Change GitHub personal access token]
+
+## Basic operations
+* [Add custom labels]
+* [Debug with SSH]
+* [Integrate with COS]
+* [Spawn OpenStack runner]
+* [Set up reactive spawning]
+
+## Security
+* [Comply with security requirements]
+
+## Development
+* [Contribute]
+
+<!--Links-->
+
+[Change repository or organization]: (how-to/change-path.md)
+[Change GitHub personal access token]: (how-to/change-token.md)
+[Add custom labels]: (how-to/add-custom-labels.md)
+[Debug with SSH]: (how-to/debug-with-ssh.md)
+[Integrate with COS]: (how-to/integrate-with-cos.md)
+[Spawn OpenStack runner]: (how-to/openstack-runner.md)
+[Set up reactive spawning]: (how-to/reactive.md)
+[Comply with security requirements]: (how-to/comply-security.md)
+[Contribute]: (how-to/contribute.md)

docs/index.md

@@ -46,15 +46,15 @@ Thinking about using the GitHub runner charm for your next project? [Get in touc
 # Contents
 
 1. [How to](how-to)
-  1. [Add custom labels](how-to/add-custom-labels.md)
   1. [Change repository or organization](how-to/change-path.md)
   1. [Change GitHub personal access token](how-to/change-token.md)
-  1. [Comply with security requirements](how-to/comply-security.md)
-  1. [Contribute](how-to/contribute.md)
+  1. [Add custom labels](how-to/add-custom-labels.md)
   1. [Debug with SSH](how-to/debug-with-ssh.md)
   1. [Integrate with COS](how-to/integrate-with-cos.md)
   1. [Spawn OpenStack runner](how-to/openstack-runner.md)
   1. [Set up reactive spawning](how-to/reactive.md)
+  1. [Comply with security requirements](how-to/comply-security.md)
+  1. [Contribute](how-to/contribute.md)
 1. [Reference](reference)
   1. [Actions](reference/actions.md)
   1. [Configurations](reference/configurations.md)