Generate orgs.json with org metadata alongside index.json

- compile.py now outputs orgs.json keyed by namespace slug, containing org
  name, description, url, maintainers, and register slug list
- Optional description field added to org schema and OGC entry
- compile workflow stages orgs.json to _site/ for GitHub Pages
- orgs.json added to .gitignore

Author: avillar

.github/scripts/compile.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""Compile registers/*/registers.yaml into a flat index.json."""
+"""Compile registers/*/registers.yaml into index.json and orgs.json."""
 
 import argparse
 import json
@@ -20,6 +20,7 @@
             "additionalProperties": False,
             "properties": {
                 "name": {"type": "string", "minLength": 1},
+                "description": {"type": "string", "minLength": 1},
                 "url": {
                     "type": "string",
                     "pattern": r"^https?://",
@@ -56,8 +57,9 @@
 _validator = jsonschema.Draft7Validator(REGISTERS_SCHEMA)
 
 
-def compile_index(registers_root: Path) -> tuple[dict, list[str]]:
+def compile(registers_root: Path) -> tuple[dict, dict, list[str]]:
     index = {}
+    orgs = {}
     errors = []
 
     for registers_file in sorted(registers_root.glob("*/registers.yaml")):
@@ -82,15 +84,20 @@ def compile_index(registers_root: Path) -> tuple[dict, list[str]]:
                 continue
             index[key] = url
 
-    return index, errors
+        orgs[org] = {
+            **data["org"],
+            "registers": list(data["registers"].keys()),
+        }
+
+    return index, orgs, errors
 
 
 def main():
     parser = argparse.ArgumentParser(description=__doc__)
     parser.add_argument(
         "--validate",
         action="store_true",
-        help="Validate only — do not write index.json",
+        help="Validate only — do not write output files",
     )
     args = parser.parse_args()
 
@@ -100,23 +107,25 @@ def main():
         print(f"ERROR: registers directory not found at {root}", file=sys.stderr)
         sys.exit(1)
 
-    index, errors = compile_index(root)
+    index, orgs, errors = compile(root)
 
     if errors:
         for e in errors:
             print(f"ERROR: {e}", file=sys.stderr)
         sys.exit(1)
 
     if args.validate:
-        print(f"OK: {len(index)} entries validated")
+        print(f"OK: {len(index)} register entries, {len(orgs)} orgs validated")
         return
 
     if "@ogc/main" in index:
         index = {"default": index["@ogc/main"], **index}
 
-    out = cwd / "index.json"
-    out.write_text(json.dumps(index, indent=2) + "\n")
-    print(f"Wrote {len(index)} entries to {out}")
+    (cwd / "index.json").write_text(json.dumps(index, indent=2) + "\n")
+    print(f"Wrote {len(index)} entries to index.json")
+
+    (cwd / "orgs.json").write_text(json.dumps(orgs, indent=2) + "\n")
+    print(f"Wrote {len(orgs)} orgs to orgs.json")
 
 
 if __name__ == "__main__":

.github/workflows/compile.yml

@@ -35,7 +35,7 @@ jobs:
       - name: Stage Pages output
         run: |
           mkdir _site
-          cp index.json index.html _site/
+          cp index.json orgs.json index.html _site/
 
       - uses: actions/upload-pages-artifact@v3
         with:

.gitignore

@@ -1,2 +1,3 @@
 index.json
+orgs.json
 _site/

registers/ogc/registers.yaml

@@ -1,5 +1,6 @@
 org:
   name: Open Geospatial Consortium
+  description: The Open Geospatial Consortium (OGC) is an international consortium of companies, government agencies, research organizations, and universities focused on developing publicly available geospatial standards
   url: https://www.ogc.org
   maintainers:
     - github: avillar