Skip to content

Stop keeping the docs schema on main; publish it only to docgen#5663

Draft
shreyas-goenka wants to merge 1 commit into
databricks:mainfrom
shreyas-goenka:shreyas-goenka/remove-docs-schema-from-main
Draft

Stop keeping the docs schema on main; publish it only to docgen#5663
shreyas-goenka wants to merge 1 commit into
databricks:mainfrom
shreyas-goenka:shreyas-goenka/remove-docs-schema-from-main

Conversation

@shreyas-goenka

@shreyas-goenka shreyas-goenka commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

Removes the checked-in docs schema from main and publishes it only to the docgen branch.

@shreyas-goenka shreyas-goenka force-pushed the shreyas-goenka/remove-docs-schema-from-main branch 2 times, most recently from 902aee9 to 6f59c51 Compare June 19, 2026 15:27
bundle/schema/jsonschema_for_docs.json was a checked-in generated artifact on
main, but nothing in the CLI reads it — the binary embeds jsonschema.json, and
bundle/docsgen regenerates from Go types. Its only consumer is downstream docs
tooling, which now reads the schema from the docgen branch.

- Delete bundle/schema/jsonschema_for_docs.json and remove generate-schema-docs
  from the `all`/`generate` aggregators and the Taskfile, so `task generate` no
  longer recreates it on main. (generate-check, the CI drift subset, already
  excluded it.)
- The update-schema-docs workflow now regenerates the schema straight into the
  docgen worktree and commits it there, instead of generating on main and
  copying. Drops the now-unneeded "assert only the docs schema changed on main"
  and capture steps.
- Drop the file from .wsignore, .gitattributes, and the auto-generated-files
  rule.

Co-authored-by: Isaac
@shreyas-goenka shreyas-goenka force-pushed the shreyas-goenka/remove-docs-schema-from-main branch from 6f59c51 to a4951a2 Compare June 19, 2026 15:30
@github-actions

Copy link
Copy Markdown
Contributor

An authorized user can trigger integration tests manually by following the instructions below:

Trigger:
go/deco-tests-run/cli

Inputs:

  • PR number: 5663
  • Commit SHA: a4951a2d04b0eda4c6be5dee22475010d52cb16b

Checks will be approved automatically on success.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant