what this is

docs/SITE-STRUCTURE.md

@@ -0,0 +1,54 @@
+# Site structure
+
+This repository is the production source for `https://familyfed.bcgen.ie/`.
+Everything is served as static files, so file paths are also URL paths.
+
+## Do not casually move these
+
+These top-level directories are public routes. Renaming or moving them changes
+the live URL unless redirects are added at the hosting layer.
+
+- `about-us/`
+- `contact/`
+- `events/`
+- `register/`
+- `services/`
+- `speeches/`
+- `the-founders/`
+- `videos/`
+- `2013-sunday-service-archive/` through `2018-sunday-service-archive/`
+- `speeches-by-rev-dr-sun-myung-moon*/`
+- `speeches-of-rev-sun-myung-moon-1995/`
+- `blog/`
+
+## Main content groups
+
+| Group | Paths | Notes |
+| --- | --- | --- |
+| Core pages | `index.html`, `about-us/`, `contact/`, `events/`, `register/`, `services/`, `the-founders/`, `videos/` | Best first targets for active maintenance. |
+| Sunday service archives | `2013-sunday-service-archive/` to `2018-sunday-service-archive/`, plus `services/` | Mostly link lists to Vimeo or YouTube. |
+| Speeches archive | `speeches/`, `speeches-by-rev-dr-sun-myung-moon*/`, `speeches-of-rev-sun-myung-moon-1995/` | Large historical text archive. |
+| Blog mirror | `blog/` | Generated archive, category, tag, and dated pages. |
+| WordPress-style assets | `wp-content/`, `wp-includes/`, `wp/`, `cdn-cgi/` | Static leftovers from the original WordPress export. Keep paths stable while pages still reference them. |
+
+## Asset locations
+
+- Theme CSS, JavaScript, fonts, and images live under `wp-content/themes/parabola/`.
+- Plugin CSS and JavaScript live under `wp-content/plugins/`.
+- Uploaded images and PDFs live under `wp-content/uploads/` and `wp/wp-content/uploads/`.
+- Cloudflare email decoding support lives under `cdn-cgi/`.
+
+For new production images or PDFs, prefer adding them under `wp-content/uploads/YYYY/MM/`
+until the site has a cleaner asset convention. That keeps the project consistent
+with the current exported pages.
+
+## Maintenance notes
+
+- Use a local web server when previewing: `python3 -m http.server 8000`.
+- Check pages at `http://localhost:8000/...`, not by opening files directly.
+- Keep edits small and URL-aware.
+- When editing shared header, navigation, or footer markup, remember that the
+  markup is duplicated across many HTML files.
+- Leftover WordPress endpoints such as `/wp-json/`, `/xmlrpc.php`, and
+  `/wp-admin/admin-ajax.php` appear in exported markup. They are not live backend
+  features in this static repo.