From f18718da5208d1a943d98abfc3c51144709fabfb Mon Sep 17 00:00:00 2001
From: tangent <rose@tangentfox.com>
Date: Sun, 16 Aug 2026 17:57:04 -0600
Subject: [PATCH 1/2] Update ReadMe.md

---
 ReadMe.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/ReadMe.md b/ReadMe.md
index c3bd580..1cff156 100644
--- a/ReadMe.md
+++ b/ReadMe.md
@@ -7,3 +7,39 @@
 - [ ] right now I just need to get it able to set up a new Gitea instance
 - [ ] in the future, it needs to be able to push to a new GitHub
 - [ ] need to be able to recognize/use local repos vs pulled ones
+
+## JSON format
+```json
+{
+  "mirrors": {
+    "https://github.com/": {
+      "TangentFoxy": {
+        "lua-sandbox": {
+          "private": false,
+          "target": "https://gitea.tangentfox.com/forks/lua-sandbox"
+        }
+      }
+    }
+  },
+  "repositories": {
+    "https://github.com/": {
+      "TangentFoxy": {
+        "github.io-podcasts": {
+          "description": "A Lua script to partially automate publishing a podcast on GitHub Pages."
+        }
+      }
+    }
+  }
+}
+```
+
+The idea is to make a tree based on the *source* of a repo,
+with special keys for what to do with that source,
+and optional `target` URLs for mirroring.
+- `description`: Short description typically displayed in lists on hosting services.
+- `private`: If a repo needs to be created, it will be private only if this is true.
+- `redundant`: This repo really doesn't need to exist, but hasn't been removed yet. (This is essentially for my own notes.)
+- `target`: A repo URL to force-push to for mirroring.
+- `website`: URL, usually displayed clickable on hosting services.
+
+I'm probably going to remove the artificial separation between mirros and repositories.

From cde0eddba208a7f173f2c50411a4fb1537220654 Mon Sep 17 00:00:00 2001
From: tangent <rose@tangentfox.com>
Date: Sun, 16 Aug 2026 17:59:21 -0600
Subject: [PATCH 2/2] Update ReadMe.md

---
 ReadMe.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/ReadMe.md b/ReadMe.md
index 1cff156..e076fc6 100644
--- a/ReadMe.md
+++ b/ReadMe.md
@@ -1,8 +1,8 @@
 # repo-manager
 
-- [ ] store repositories keyed by name
-  - [ ] repositories have a ~~source~~ origin url and optional mirror URLs
-  - [ ] optional "name" key for handling name conflicts in the main list
+- [x] store repositories keyed by name (tree-style is better for avoiding conflicts while being specific and easy to follow)
+  - [x] repositories have a ~~source~~ origin url and optional mirror URLs (just one for now, called `target`)
+  - [x] optional "name" key for handling name conflicts in the main list (due to tree structure, unnecessary)
 - [ ] have to specify what is being restored or changed or copied
 - [ ] right now I just need to get it able to set up a new Gitea instance
 - [ ] in the future, it needs to be able to push to a new GitHub