Attempting to sort docfx page layout & menu

Author: bfren

docs/.gitignore

@@ -1,68 +1,60 @@
 {
-    "metadata": [
-      {
-        "src": [
-          {
-            "src": "../src",
-            "files": [
-              "Rqlite.Client/bin/**/*.dll"
-            ]
-          }
-        ],
-        "dest": "api",
-        "includePrivateMembers": false,
-        "disableGitFeatures": false,
-        "disableDefaultFilter": false,
-        "noRestore": false,
-        "namespaceLayout": "flattened",
-        "memberLayout": "separatePages",
-        "EnumSortOrder": "alphabetic",
-        "allowCompilationErrors": false
-      }
-    ],
-    "build": {
-      "content": [
-        {
-          "files": [
-            "api/**.yml",
-            "api/index.md"
-          ]
-        },
+  "metadata": [
+    {
+      "src": [
         {
+          "src": "../src",
           "files": [
-            "articles/**.md",
-            "articles/**/toc.yml",
-            "toc.yml",
-            "*.md"
+            "Rqlite.Client/bin/**/*.dll"
           ]
         }
       ],
-      "resource": [
-        {
-          "files": [
-            "images/**"
-          ]
-        }
-      ],
-      "globalMetadata": {
-        "_appTitle": "Rqlite",
-        "_appName": "Rqlite",
-        "_appFooter": "<span>Copyright (c) 2023-2024 <a href=\"https://bfren.dev\">bfren</a>. Made with <a href=\"https://dotnet.github.io/docfx\">docfx</a></span>"
-      },
-      "sitemap": {
-        "baseUrl": "https://bfren.github.io/rqlite",
-        "priority": 0.5,
-        "changefreq": "daily"
-      },
-      "globalMetadataFiles": [],
-      "fileMetadataFiles": [],
-      "output": "_site",
-      "template": [
-        "default",
-        "modern"
-      ],
-      "postProcessors": [],
-      "keepFileLink": false,
-      "disableGitFeatures": false
+      "dest": "api",
+      "includePrivateMembers": false,
+      "disableGitFeatures": false,
+      "disableDefaultFilter": false,
+      "noRestore": false,
+      "namespaceLayout": "flattened",
+      "memberLayout": "separatePages",
+      "EnumSortOrder": "alphabetic",
+      "allowCompilationErrors": false
     }
-  }
+  ],
+  "build": {
+    "content": [
+      {
+        "files": [
+          "api/**.yml",
+          "api/index.md"
+        ]
+      }
+    ],
+    "resource": [
+      {
+        "files": [
+          "images/**"
+        ]
+      }
+    ],
+    "globalMetadata": {
+      "_appTitle": "Rqlite",
+      "_appName": "Rqlite",
+      "_appFooter": "<span>Copyright &copy; 2023-2024 <a href=\"https://bfren.dev\">bfren</a>. Made with <a href=\"https://dotnet.github.io/docfx\">docfx</a></span>"
+    },
+    "sitemap": {
+      "baseUrl": "https://bfren.github.io/rqlite",
+      "priority": 0.5,
+      "changefreq": "daily"
+    },
+    "globalMetadataFiles": [],
+    "fileMetadataFiles": [],
+    "output": "_site",
+    "template": [
+      "default",
+      "modern"
+    ],
+    "postProcessors": [],
+    "keepFileLink": false,
+    "disableGitFeatures": false
+  }
+}

docs/api/.gitignore

@@ -0,0 +1,6 @@
+- name: Get Started
+- href: ../index.md
+
+- name: Essentials
+- href: configuration.md
+- href: querying.md

docs/docfx.json

@@ -5,28 +5,14 @@ This is a community client for accessing [Rqlite](https://rqlite.io) from .NET a
 ## Contents
 
 * [Installation](#installation)
-* [Readme App](#readme-app)
 * [Usage](#usage)
+* [Readme App](#readme-app)
 * [Licence / Copyright](#licence)
 
 ## Installation
 
 You can either download and build the source yourself in your own project, or install the [NuGet Package](https://nuget.org/packages/rqlite).
 
-## Readme App
-
-To see the library in action, the source contains a Readme App.  Simply checkout the repository, spin up a Rqlite instance (Docker required), and run the project:
-
-```bash
-# in a temporary directory of your choice
-$ git checkout https://github.com/bfren/rqlite .
-$ chmod +x run.sh
-$ ./run.sh
-
-# in a new terminal
-$ dotnet run --project apps/ReadmeApp
-```
-
 ## Usage
 
 The recommended way to use `Rqlite.Client` is via dependency injection.  Support for `Microsoft.Extensions.DependencyInjection` is included, e.g.
@@ -64,6 +50,20 @@ var items = await client.QueryAsync<Item>("SELECT * FROM item WHERE id = :id", n
 
 NB: This client is **async only** so you **must** use it within `async` methods so you can make use of the `await` keyword.
 
+## Readme App
+
+To see the library in action, the source contains a Readme App.  Simply checkout the repository, spin up a Rqlite instance (Docker required), and run the project:
+
+```bash
+# in a temporary directory of your choice
+$ git checkout https://github.com/bfren/rqlite .
+$ chmod +x run.sh
+$ ./run.sh
+
+# in a new terminal
+$ dotnet run --project apps/ReadmeApp
+```
+
 ## Licence
 
 > [MIT](https://mit.bfren.dev/2023)

docs/configuration.md docs/docs/configuration.md

@@ -1,8 +1,6 @@
-- name: Get Started
-- href: index.md
-- href: configuration.md
-- href: querying.md
-
+- name: Docs
+  href: docs/
+  homepage: docs/configuration.md
 - name: API
   href: api/
   homepage: api/index.md