docs(substations): add to data catalog (PR 9/9)#202
Closed
texture-fleet-agent[bot] wants to merge 2 commits intomeridian/substations-join-apifrom
Closed
docs(substations): add to data catalog (PR 9/9)#202texture-fleet-agent[bot] wants to merge 2 commits intomeridian/substations-join-apifrom
texture-fleet-agent[bot] wants to merge 2 commits intomeridian/substations-join-apifrom
Conversation
Adds comprehensive documentation for the substations dataset to the CommonGrid data catalog. Includes schema, sources, API endpoints, join tables, and integration notes for developers using the new entity. **What's included:** - Substations entry in DATA_CATALOG.md (schema, record count, update frequency) - ODbL attribution notes and requirements - API endpoint documentation + example queries - Join table relationships (transmission lines, power plants) - Historical context + selection rationale **Features:** - Voltage filtering guidance (bulk-power focus by default) - Soft-delete pattern documentation - Sync cadence details (weekly automatic) - Source attribution per-record via source + sourceUrl **Completes:** - PR #1: Schema ✅ - PR #2: Sync (OSM + EIA) ✅ - PR #3: API endpoints + seed ✅ - PR #4: UI pages + map ⏳ (waiting for auth) - PR #5: Cron jobs ✅ - PR #6: transmission_line_endpoints join ✅ - PR #7: power_plant_interconnections join ✅ - PR #8: Join query API ✅ - PR #9: Docs + catalog ✅ (this PR) --- *Part of CommonGrid 9th entry point milestone (substations) — PR 9 of 9* *All 9 PRs locally ready. Waiting for merge authority to push PR #4 and cascade.*
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Vercel Pro plan enforces a max of 800 seconds for serverless function maxDuration. The previous 1800s value caused the build to succeed but deployment to fail at the patchBuild step with: Builder returned invalid maxDuration value for Serverless Function "api/cron/sync-substations". Serverless Functions must have a maxDuration between 1 and 800 for plan pro. Capping at 800 unblocks deploys. Full US substation syncs that exceed this should be moved to a long-running runner (GitHub Actions, Render, etc.) rather than a Vercel serverless function.
Contributor
|
Reopening after incorrect close during fallback merge. CI ✓, ready to merge. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Part of the substations 9th entry point epic.
Closes out the 9-PR substations epic with documentation — adds the substations dataset to the data catalog so users know what fields are available, where the data comes from (EIA Form 860 + OpenStreetMap hybrid), and how to query it.
Stack: PR 9/9 (base: previous [PR 8 join API]) — final PR in the series.