This repository contains a foundational proposal for a federated network of
OpenGeoMetadata API mirrors. The model pairs a shared, protected API endpoint
with independently hosted institutional mirrors and configurable OGM
Discovery (ogm-discovery) frontends on GitHub Pages.
Open the site landing page to browse the complete proposal as a static website.
| Field | Value |
|---|---|
| Status | Draft for Community Discussion |
| Document ID | OGM-DISCUSSION-2026-01 |
| Version | 0.1.0 |
| Proposal lead | Eric Larson (ewlarson@gmail.com) |
| Date | August 19, 2026 |
| Discussion | Repository issue tracker |
| Approval | None; this is not an approved OGM roadmap or standard |
The proposed lifecycle is Community Discussion Draft -> Pilot Candidate -> Approved Pilot -> Production Proposal -> Accepted, Rejected, Withdrawn, or Superseded. Sponsorship, the formal review window, and decision authority remain to be designated by OGM governance.
- Technical implementation guide
- Standalone HTML preview
- Technical architecture diagram
- Cache strategy diagram
The PDF can be regenerated with:
python3 scripts/build_executive_brief.pyBoth standalone HTML documents can be regenerated with:
python3 scripts/build_site.pyThis requires Pandoc. The generated documents are self-contained: their CSS and SVG diagrams are embedded so they remain portable outside the Pages site.
The repository includes a project-path-safe index.html, relative links, a
dependency-free site validator, and a GitHub Actions deployment workflow.
- In the GitHub repository, open Settings > Pages.
- Set Source to GitHub Actions.
- Push to
main, or run Deploy GitHub Pages manually from the Actions tab.
The workflow validates the committed HTML against its Markdown source, stages only the public materials, and deploys them. Run the same validation locally:
python3 scripts/check_pages_site.py