docs: data-publishing user guide + configuration - #178
Merged
Conversation
Add a comprehensive user guide for the data-publishing feature under the User Guide (usage/data-publishing, between damage-mapping and building-blocks): choosing a target (Local vs Planetary Computer), publishing from Results, managing published datasets (statuses, edit, retry, unpublish, force-remove), source-imagery attribution, viewing in the PC Explorer, and enabling/configuring the feature (in-app env + out-of-app GeoCatalog setup with links to the official MPC Pro docs). Also: a Data publishing section in the configuration guide (full HASTE_* env matrix), a PC prerequisites note in the deployment guide, and cross-links from the overview and both workflow Results sections. Builds clean with jupyter-book (no new warnings).
Wire the 7 captures into usage/data-publishing.md: the target dropdown, the Publish dataset menu item and dialog, the Published Datasets list (with the row action menu) and detail view, the edit-metadata form, and the damage-classification layer in the Planetary Computer Explorer. Refine the publish steps to match the dialog's actual labels/order (Assets to publish, Target publishing location). Explorer capture downscaled to 1920px to match the repo's image budget.
Copilot started reviewing on behalf of
Anthony Cintron (prbatero)
August 31, 2026 15:22
View session
Contributor
There was a problem hiding this comment.
Pull request overview
Adds user, configuration, and deployment documentation for data publishing, including Planetary Computer integration pending PR #175.
Changes:
- Adds the Publishing Datasets user guide.
- Documents publishing configuration and deployment prerequisites.
- Adds navigation and workflow cross-links.
Reviewed changes
Copilot reviewed 7 out of 14 changed files in this pull request and generated 8 comments.
Show a summary per file
| File | Description |
|---|---|
docs/usage/data-publishing.md |
Adds the publishing user guide. |
docs/configuration.md |
Documents publishing settings. |
docs/deployment.md |
Adds deployment prerequisites. |
docs/_toc.yml |
Registers the new guide. |
docs/usage/overview.md |
Links publishing from the overview. |
docs/usage/damage-mapping.md |
Links publishing from results. |
docs/usage/rapid-building-assessment.md |
Links publishing from assessments. |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
- data-publishing: add a Contents list (repo doc guideline); note the valid-area mask must stay selected for Planetary Computer (a publish without it is rejected); clarify Published Datasets is tenant-wide (all authenticated users see every published dataset), and that View details is available to everyone while edit/retry/unpublish/force-remove are owner/admin only; scope the 'never publishes source pixels' claim to the PC target and note Local can archive the processed image within HASTE; add the missing GeoCatalog data-plane RBAC grant to the setup and fix the 'both grants' wording to three. - deployment: list the GeoCatalog data-plane grant alongside the two storage grants. - configuration: document that PUBLISH_STORAGE_ACCOUNT_URL and PUBLISH_BLOB_CONTAINER are an all-or-nothing pair (either empty falls back to in-place primary storage, which a firewalled GeoCatalog can't ingest). - _config: enable myst_heading_anchors so the Contents links resolve (also clears the pre-existing configuration.md TOC warnings). Builds clean with jupyter-book (no new warnings).
1 task
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
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.
Adds documentation for the data-publishing feature to the docs site (
docs/), consistent with the existing User Guide style.What's added
derived_from/citation, and the licensing safeguard (only registered open-data imagery is attributed; source pixels are never published)HASTE_*env matrix (feature flags, PC target, publish storage + attribution) and a Contents entryValidation
Builds locally with
jupyter-book build docs/— build succeeds, no new warnings on any changed page.The Viewing in the Planetary Computer Explorer section and the
HASTE_PUBLISH_EXPLORER_RENDER_ENABLEDrow document the Explorer visualization that is still in-flight in #175. Merge this docs PR after #175 so the site matchesmain.