From fe2d91b0b333a056ac020d7f7a7f9d3b54a7a52a Mon Sep 17 00:00:00 2001
From: Lee Cattarin <lee.cattarin@gmail.com>
Date: Fri, 25 Sep 2026 12:38:36 -0700
Subject: [PATCH] documentation

---
 DRONE.md           | 66 +++++++++++++++++++++++++++++++++++++++++
 README.md          | 74 +++-------------------------------------------
 src/pages/about.md |  1 -
 3 files changed, 70 insertions(+), 71 deletions(-)
 create mode 100644 DRONE.md

diff --git a/DRONE.md b/DRONE.md
new file mode 100644
index 0000000..366d087
--- /dev/null
+++ b/DRONE.md
@@ -0,0 +1,66 @@
+# Drone/Submodule setup
+
+## 1. create repo
+
+in heckin gitea, create destination repo.
+
+## 2. update dronefile in source repo
+
+Update the `<placeholder values>` in [.drone.yml](.drone.yml).
+
+## 3. create and add PAT (one-time, not per repo)
+
+in heckin, go to settings > applications, and create a PAT with read & write permissions to repositories.
+
+in drone, you can set your PAT either as a project secret or an organization secret. In either case call it `GIT_TOKEN`.
+
+## 4. activate project in drone
+
+in drone, find your project and activate it.
+
+in the settings, I chose to disable pull requests and forks. I set my runner timeout to 15m.
+
+## 5. first commit to submodule
+
+assuming we are committing the _site folder...
+
+```sh
+cp -r _site ../temp
+cd ../temp
+
+git init
+git add -A
+git commit -m "first"
+
+git remote add origin <remote-url>
+git push -u origin main
+```
+
+then you can delete the temp directory.
+
+## 6. add submodule to local repo
+
+in root dir of local repo, add the submodule.
+
+```sh
+git submodule add <remote-url>
+```
+
+if you used the SSH url, set it to the HTTPS url.
+
+```sh
+git submodule set-url <dest-repo> <remote-url-https>
+git add .gitmodules # the changes from submodule add are auto-staged, this config change isn't
+```
+
+commit your changes and push.
+
+```sh
+git commit -m "add submodule"
+```
+
+(commit your dronefile changes too.)
+
+## 7. profit
+
+if it doesn't work, cry
diff --git a/README.md b/README.md
index 048e4a0..6b98ec2 100644
--- a/README.md
+++ b/README.md
@@ -10,75 +10,9 @@ Always remember to check for changes before starting work, and sync your changes
 
 Please import images in the "Media Library" tab - uploading them directly via post creation seems to create issues with the image pathing.
 
-## Nested navigation
+## Nested navigation for pages
 
-To create *accessible* nested navigation, make sure to turn the "Permalink" setting under the "Navigation" tab OFF for the top level of the nested section. This ensures that the menu can be clickable to open rather than hover-able.
+To create more accessible nested navigation:
 
----
-
-## full drone/submodule setup from scratch
-
-### 1. create repo
-
-in heckin gitea, create destination repo.
-
-### 2. update dronefile in source repo
-
-Update the `<placeholder values>` in [.drone.yml](.drone.yml).
-
-### 3. create and add PAT (one-time, not per repo)
-
-in heckin, go to settings > applications, and create a PAT with read & write permissions to repositories.
-
-in drone, you can set your PAT either as a project secret or an organization secret. In either case call it `GIT_TOKEN`.
-
-### 4. activate project in drone
-
-in drone, find your project and activate it.
-
-in the settings, I chose to disable pull requests and forks. I set my runner timeout to 15m.
-
-### 5. first commit to submodule
-
-assuming we are committing the _site folder...
-
-```sh
-cp -r _site ../temp
-cd ../temp
-
-git init
-git add -A
-git commit -m "first"
-
-git remote add origin <remote-url>
-git push -u origin main
-```
-
-then you can delete the temp directory.
-
-### 6. add submodule to local repo
-
-in root dir of local repo, add the submodule.
-
-```sh
-git submodule add <remote-url>
-```
-
-if you used the SSH url, set it to the HTTPS url.
-
-```sh
-git submodule set-url <dest-repo> <remote-url-https>
-git add .gitmodules # the changes from submodule add are auto-staged, this config change isn't
-```
-
-commit your changes and push.
-
-```sh
-git commit -m "add submodule"
-```
-
-(commit your dronefile changes too.)
-
-### 7. profit
-
-if it doesn't work, cry
+- Create the top level page and turn the "Linkable" setting to OFF (eye with a slash through it)
+- Create the lower level pages as normal
diff --git a/src/pages/about.md b/src/pages/about.md
index 5921f4c..f74336d 100644
--- a/src/pages/about.md
+++ b/src/pages/about.md
@@ -7,4 +7,3 @@ eleventyNavigation:
 ___mb_schema: /.mattrbld/schemas/page.json
 permalink: false
 ---
-Here’s some body text