Fix order, slug and titles

Author: Ndpnt

content/analysis/how-to/publish.md renamed to content/analysis/how-to/publish-memo.md

@@ -1,9 +1,9 @@
 ---
-title: CLI
+title: Command line interface
 weight: 1
 ---
 
-# CLI
+# Command line interface
 
 Once the engine module is installed as a dependency within another module, the `ota` command with the following subcommands is available.
 

content/api/cli.md

@@ -3,7 +3,7 @@ title: Collection REST API
 weight: 2
 ---
 
-# Collection Web API
+# Collection REST API
 
 As Open Terms Archive is decentralised, each instance embarks its own API. The documentation relevant to the specific version of the engine on that instance is provided on that instance itself.
 

content/api/collection.md

@@ -4,7 +4,7 @@ weight: 3
 aliases: /api/federated/
 ---
 
-# Federation API
+# Federation REST API
 
 Open Terms Archive is a decentralised system that tracks collections of services' terms across multiple servers. Each collection operates its own API, and the Federation API unifies search and discovery across collections, fostering collaboration with external applications.
 

content/api/federation.md

@@ -1,5 +1,5 @@
 ---
-title: Node.JS module
+title: Node.js module
 weight: 1
 ---
 

content/api/node.md

@@ -3,7 +3,7 @@ title: Create repositories
 weight: 1
 ---
 
-# Create Collection Repositories
+# How to create collection repositories
 
 Collections in Open Terms Archive rely on three Git repositories to hold the data:
 - Declarations repository: stores the declarations that define terms to track
@@ -19,16 +19,16 @@ Before starting, ensure you have:
 - Your collection ID and name defined
 - Your collection metadata prepared
 
-## Create Declarations Repository
+## Create declarations repository
 
-### Create from Template
+### Create from template
 
 1. Go to the [`demo-declarations`](https://github.com/OpenTermsArchive/demo-declarations) repository
 2. Click "Use this template" dropdown and select "Create a new repository"
 3. Name it `<collection_id>-declarations` (e.g. `pga-declarations`)
 4. Wait 1-2 minutes for automatic setup to complete (check `first-time-setup` action status)
 
-### Configure Repository Settings
+### Configure repository settings
 
 1. Set up the "About" section:
    - Click the cogwheel icon next to "About"
@@ -57,16 +57,16 @@ Before starting, ensure you have:
    - Update README with collection metadata
    - Update `metadata.yml` with collection metadata
 
-## Create Snapshots Repository
+## Create snapshots repository
 
-### Create from Template
+### Create from template
 
 1. Go to [`demo-snapshots`](https://github.com/OpenTermsArchive/demo-snapshots)
 2. Click "Use this template" and select "Create a new repository"
 3. Name it `<collection_id>-snapshots`
 4. Wait for automatic setup to complete
 
-### Configure Repository
+### Configure repository
 
 1. Set up "About" section:
    - Add description: "Documents snapshots for `<collection_name>`. Maintained by `<maintainer>`."
@@ -78,16 +78,16 @@ Before starting, ensure you have:
    - Disable Wikis, Issues, Discussions, and Projects
    - Disable GitHub Actions
 
-## Create Versions Repository
+## Create versions repository
 
-### Create from Template
+### Create from template
 
 1. Go to [`demo-versions`](https://github.com/OpenTermsArchive/demo-versions)
 2. Click "Use this template" and select "Create a new repository"
 3. Name it `<collection_id>-versions`
 4. Wait for automatic setup to complete
 
-### Configure Repository
+### Configure repository
 
 1. Set up "About" section:
    - Add description: "Terms versions for `<collection_name>`. Maintained by `<maintainer>`."
@@ -101,7 +101,7 @@ Before starting, ensure you have:
 
 3. Update README with collection metadata
 
-## Set up GitHub Teams
+## Set up GitHub teams
 
 For collections within the Open Terms Archive organization:
 
@@ -117,7 +117,7 @@ For collections within the Open Terms Archive organization:
 4. Add team members
 5. Add repositories to Bots team with "Write" access
 
-## Verify Setup
+## Verify setup
 
 1. Check that all repositories were created successfully
 2. Verify repository settings are correctly configured

content/collections/how-to/create-repositories.md

@@ -1,9 +1,9 @@
 ---
-title: Creating a collection
+title: Create a collection
 weight: 3
 ---
 
-# Creating a collection
+# How to create a collection
 
 You are considering creating a new collection to track terms with Open Terms Archive? Amazing!
 

content/collections/how-to/create-collection.md renamed to content/collections/how-to/create.md

@@ -1,9 +1,9 @@
 ---
-title: Define Metadata
+title: Define metadata
 weight: 2
 ---
 
-# Define Metadata
+# How to define metadata
 
 This guide will help you create the metadata.yml file for your Open Terms Archive collection.
 

content/collections/how-to/define-metadata.md

@@ -1,12 +1,14 @@
 ---
 title: Configuration
-weight: 3
+weight: 2
 ---
 
 # Configuration options
 
 This reference documentation details all available configuration options that can be specified in a collection's configuration file to configure the Open Terms Archive engine.
 
+As an example, see the [production configuration file](https://github.com/OpenTermsArchive/demo-declarations/blob/main/config/production.json) of the [Demo collection](https://github.com/OpenTermsArchive/demo-declarations).
+
 ## Options
 
 {{< configOption
@@ -298,7 +300,3 @@ The MongoDB storage configuration allows to store versions in a MongoDB database
     description="Collection name."
     default="`snapshots`"
 >}}
-
----
-
-As an example, see the [production configuration file](https://github.com/OpenTermsArchive/demo-declarations/blob/main/config/production.json) of the [Demo collection](https://github.com/OpenTermsArchive/demo-declarations).

content/collections/reference/configuration.md

@@ -1,6 +1,6 @@
 ---
-title: Environment Variables
-weight: 4
+title: Environment variables
+weight: 3
 ---
 
 ## Environment variables