Build registry-driven wrangle documentation - #26
Merged
Conversation
Group the 98 runtime wrangles into namespace documentation while preserving direct entry and machine-readable registry artifacts. Add parameter-group metadata, lifecycle replacements, integrated examples, playground actions, and the shared presentation layer for generated pages.
18 tasks
Separate the legacy _sources retirement from the WranglesPY _schema migration, document the production gates, remove Registry Pilot terminology and special bootstrap cases, and move generated recipe schema output to the neutral registry path.\n\nTrack the remaining cutover work in issue #27.
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.
Summary
mathsas replaced bymathand standalonestandardizeas replaced bystandardize.custom._sourcesdocumentation workflow and moving schema authority from hand-maintained WranglesPY_schemacontent to the Docs Registry.pre-productioncontract and measurable production-readiness criteria.Behavior and compatibility
/wrangledocumentation pages and routes remain available; this PR does not deploy the site or perform the final route cutover./wranglesnavigation is labeled Registry and favors namespace-grouped pages with stable wrangle anchors.bootstrap:registrycreates missing records only and never overwrites existing authoritative records./schemas/recipes/pilot/schema.jsonto/schemas/recipes/registry/schema.json.Validation
npm run bootstrap:registry— created 0 records and preserved all 98 existing entries.npm run check:registry— passed; all 327 generated artifacts are current.npm run typecheck— passed.npm run build— passed and produced the Registry index plus namespace and direct-entry routes.git diff --cached --check— clean before commit.origin/mainbefore push.Known warnings
The production build succeeds with pre-existing Docusaurus configuration, Browserslist, and old Excel/Python documentation link warnings. No new Registry broken-link warning was introduced.
Remaining work
The Registry remains pre-production. Issue #27 tracks the
_sourcesretirement, schema-consumer cutover, UUID completion, example execution verification, immutable public artifacts, and the first production Registry release.Wrangle descriptions and examples also remain subject to later editorial curation. This PR completes the roughly 80 percent Registry and presentation foundation intended for that follow-on work.
Closes no issue; tracks remaining cutover work in #27.
Rollback
Revert this PR to restore the previous Registry generation, presentation, and pilot-path behavior. Existing
/wrangledocumentation is not removed by this change.