blumeops/docs/how-to
Erich Blume 4f0476a851
All checks were successful
Build Container / detect (push) Successful in 3s
Build Container (Nix) / detect (push) Successful in 1s
Build Container (Nix) / build (quartz) (push) Successful in 1s
Build Container / build (quartz) (push) Successful in 10s
Fix spider trap: disable SPA mode, remove index files, relax wiki-links (#290)
## Summary

Fixes the Facebook crawler spider trap that's been generating infinite recursive URLs like `/how-to/tutorials/tutorials/how-to/explanation/...` for several days.

**Root cause:** Quartz SPA mode + nginx `try_files` fallback to `index.html` meant any fabricated URL returned the root HTML shell with HTTP 200. Crawlers followed relative links from those fake URLs, creating infinite recursion.

**Fix:**
- Disable Quartz SPA mode (`enableSPA: false`) — all pages are now fully static HTML
- Replace nginx SPA fallback with `=404` + Quartz's static `404.html`
- Remove `robots.txt` exclusions (no longer needed)

**Docs cleanup (Obsidian.nvim compat no longer needed):**
- Delete hand-curated category index files (`tutorials.md`, `reference.md`, `how-to.md`, `explanation.md`) — Quartz auto-generates folder pages
- Delete `postgresql-storage.md` (redirect stub) and `migrate-forgejo-from-brew.md` (stale history)
- Drop `docs-check-index` and `docs-check-filenames` prek hooks
- Rewrite `docs-check-links` to allow path-based wiki-links (`[[path/to/file]]`) and only error on true ambiguity
- Add `ai-docs` doc tree listing to replace index files for AI context
- Add natural cross-links from reference cards to fix orphan docs

## Deployment and Testing

- [ ] Merge and let the build pipeline run
- [ ] Verify docs.eblu.me serves pages correctly with full page loads
- [ ] Verify non-existent URLs return 404
- [ ] Monitor crawler traffic — should drop to near zero for fabricated URLs

Reviewed-on: #290
2026-03-09 11:59:43 -07:00
..
authentik Remove mikado frontmatter from closed chains, clarify finalization rules 2026-03-04 20:43:19 -08:00
configuration Retire plans directory, convert migrate-forgejo-from-brew to mikado card 2026-03-04 20:28:14 -08:00
dagger Add how-to guide for upgrading Dagger 2026-03-06 20:31:30 -08:00
deployment Expose Forgejo publicly at forge.eblu.me (#278) 2026-03-03 08:40:41 -08:00
forgejo-runner Remove mikado frontmatter from closed chains, clarify finalization rules 2026-03-04 20:43:19 -08:00
grafana Remove mikado frontmatter from closed chains, clarify finalization rules 2026-03-04 20:43:19 -08:00
jobsync Add JobSync reference card, observability docs, and RAPIDAPI_KEY plumbing (#289) 2026-03-08 15:06:52 -07:00
knowledgebase Review and update review-services.md 2026-03-07 09:03:08 -08:00
operations Review manage-flyio-proxy.md — no issues found 2026-03-07 09:03:46 -08:00
ringtail Update ringtail flake inputs, add flake-update pipeline (#240) 2026-02-22 08:17:52 -08:00
zot Remove mikado frontmatter from closed chains, clarify finalization rules 2026-03-04 20:43:19 -08:00
agent-change-process.md Remove mikado frontmatter from closed chains, clarify finalization rules 2026-03-04 20:43:19 -08:00