Conversation
|
We detected some changes at Caution DO NOT create changesets for features which you do not wish to be included in the public changelog of the next CLI release. |
There was a problem hiding this comment.
Pull request overview
Updates the CLI documentation generation tooling to support the v2 docs pipeline by upgrading @shopify/generate-docs, emitting @publicDocs JSDoc on generated flag interfaces, and aligning command/interface descriptions via a shared type-descriptions.json source of truth.
Changes:
- Upgrade
@shopify/generate-docsfrom0.15.6to1.1.1(and update lockfile). - Update the docs generator (
generate.ts) to readdocs-shopify.dev/type-descriptions.jsonand to add@publicDocsJSDoc to generated*.interface.tsfiles. - Regenerate command
*.doc.tstemplates and command flag interface files, and update scripts to include/copygenerated_docs_data_v2.json.
Reviewed changes
Copilot reviewed 170 out of 175 changed files in this pull request and generated 4 comments.
Show a summary per file
| File | Description |
|---|---|
package.json |
Bumps @shopify/generate-docs dependency to 1.1.1. |
pnpm-lock.yaml |
Lockfile update reflecting the @shopify/generate-docs@1.1.1 upgrade. |
packages/cli/src/cli/commands/docs/generate.ts |
Reads type-descriptions.json for descriptions; emits @publicDocs JSDoc on generated flag interfaces. |
packages/cli/src/cli/commands/docs/generate.test.ts |
Updates unit tests/mocks for the new readFile dependency and new generated output. |
docs-shopify.dev/type-descriptions.json |
Adds canonical per-interface description strings used to align v1/v2 outputs. |
bin/docs/build-dev-docs.sh |
Copies the new generated_docs_data_v2.json (and other generated artifacts) to the world repo path when present. |
bin/create-doc-pr.js |
Includes generated_docs_data_v2.json when creating PRs for shopify-dev docs updates. |
docs-shopify.dev/commands/app-build.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/app-bulk-cancel.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/app-bulk-execute.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/app-bulk-status.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/app-config-link.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/app-config-pull.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/app-config-use.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/app-config-validate.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/app-deploy.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/app-dev-clean.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/app-dev.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/app-env-pull.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/app-env-show.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/app-execute.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/app-function-build.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/app-function-info.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/app-function-replay.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/app-function-run.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/app-function-schema.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/app-function-typegen.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/app-generate-extension.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/app-import-custom-data-definitions.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/app-import-extensions.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/app-info.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/app-init.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/app-logs-sources.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/app-logs.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/app-release.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/app-versions-list.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/app-webhook-trigger.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/auth-login.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/commands.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/help.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/hydrogen-build.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/hydrogen-check.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/hydrogen-codegen.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/hydrogen-customer-account-push.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/hydrogen-debug-cpu.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/hydrogen-deploy.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/hydrogen-dev.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/hydrogen-env-list.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/hydrogen-env-pull.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/hydrogen-env-push.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/hydrogen-generate-route.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/hydrogen-generate-routes.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/hydrogen-init.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/hydrogen-link.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/hydrogen-list.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/hydrogen-login.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/hydrogen-logout.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/hydrogen-preview.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/hydrogen-setup-css.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/hydrogen-setup-markets.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/hydrogen-setup-vite.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/hydrogen-setup.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/hydrogen-unlink.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/hydrogen-upgrade.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/organization-list.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/store-auth.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/store-execute.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/theme-check.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/theme-console.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/theme-delete.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/theme-dev.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/theme-duplicate.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/theme-info.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/theme-init.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/theme-language-server.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/theme-list.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/theme-metafields-pull.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/theme-open.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/theme-package.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/theme-preview.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/theme-profile.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/theme-publish.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/theme-pull.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/theme-push.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/theme-rename.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/theme-share.doc.ts |
Regenerated command doc template using the new description source-of-truth. |
docs-shopify.dev/commands/interfaces/app-build.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/app-bulk-cancel.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/app-bulk-execute.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/app-bulk-status.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/app-config-link.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/app-config-pull.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/app-config-use.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/app-config-validate.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/app-deploy.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/app-dev-clean.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/app-dev.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/app-env-pull.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/app-env-show.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/app-execute.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/app-function-build.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/app-function-info.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/app-function-replay.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/app-function-run.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/app-function-schema.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/app-function-typegen.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/app-generate-extension.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/app-import-custom-data-definitions.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/app-import-extensions.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/app-info.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/app-init.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/app-logs-sources.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/app-logs.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/app-release.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/app-versions-list.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/app-webhook-trigger.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/auth-login.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/auth-logout.interface.ts |
Regenerated empty flags interface with @publicDocs JSDoc (no description text). |
docs-shopify.dev/commands/interfaces/commands.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/config-autocorrect-off.interface.ts |
Regenerated empty flags interface with @publicDocs JSDoc (no description text). |
docs-shopify.dev/commands/interfaces/config-autocorrect-on.interface.ts |
Regenerated empty flags interface with @publicDocs JSDoc (no description text). |
docs-shopify.dev/commands/interfaces/config-autocorrect-status.interface.ts |
Regenerated empty flags interface with @publicDocs JSDoc (no description text). |
docs-shopify.dev/commands/interfaces/help.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/hydrogen-build.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/hydrogen-check.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/hydrogen-codegen.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/hydrogen-customer-account-push.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/hydrogen-debug-cpu.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/hydrogen-deploy.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/hydrogen-dev.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/hydrogen-env-list.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/hydrogen-env-pull.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/hydrogen-env-push.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/hydrogen-generate-route.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/hydrogen-generate-routes.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/hydrogen-init.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/hydrogen-link.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/hydrogen-list.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/hydrogen-login.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/hydrogen-logout.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/hydrogen-preview.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/hydrogen-shortcut.interface.ts |
Regenerated empty flags interface with @publicDocs JSDoc (no description text). |
docs-shopify.dev/commands/interfaces/hydrogen-setup-css.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/hydrogen-setup-markets.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/hydrogen-setup-vite.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/hydrogen-setup.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/hydrogen-unlink.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/hydrogen-upgrade.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/organization-list.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/search.interface.ts |
Regenerated empty flags interface with @publicDocs JSDoc (no description text). |
docs-shopify.dev/commands/interfaces/store-auth.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/store-execute.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/theme-check.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/theme-console.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/theme-delete.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/theme-dev.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/theme-duplicate.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/theme-info.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/theme-init.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/theme-language-server.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/theme-list.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/theme-metafields-pull.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/theme-open.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/theme-package.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/theme-preview.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/theme-profile.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/theme-publish.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/theme-pull.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/theme-push.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/theme-rename.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/theme-share.interface.ts |
Regenerated flags interface with @publicDocs JSDoc. |
docs-shopify.dev/commands/interfaces/upgrade.interface.ts |
Regenerated empty flags interface with @publicDocs JSDoc (no description text). |
docs-shopify.dev/commands/interfaces/version.interface.ts |
Regenerated empty flags interface with @publicDocs JSDoc (no description text). |
Files not reviewed (1)
- pnpm-lock.yaml: Language not supported
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
dmerand
left a comment
There was a problem hiding this comment.
I'm not an expert in this pipeline but my robots found something worth 👀 and I've vetted that.
…place as doc ts is going away
…hodology of outputting the ts files js doc comment description (delete hard coded json with this info)
9bfa39f to
9a6db95
Compare
Add @publicdocs tags and upgrade @shopify/generate-docs to v1.1.1 for v2 doc pipeline
🎟️ Part of https://github.com/shop/issues-learn/issues/1466
🎩 Top hatting portion of PR in shopify-dev: https://github.com/shop/world/pull/577553
I've migrated 90% of our gen docs now, and y'all do it... uhm different than the rest lol. If you don't like how I modified your docs, we can merge this and then your team can decide how you want things to change. Just let me get this migration done and then it's yours to change as you want (within reason)>
Summary
exactly (77/79 exact, 2 whitespace-only diffs from v2 JSDoc parser)
generated_static_pages.json, generated_category_pages.json) to the shopify-dev world repo
How it works
Changes to generate.ts
- Before: description came from command.descriptionWithMarkdown ?? command.description ?? command.summary (oclif
command object)
- Now: reads type-descriptions.json first, uses that as primary source, falls back to oclif command if the type isn't
in the JSON
- Before: no JSDoc, no description, no @publicdocs tag
- Now: reads the same type-descriptions.json, formats the description as a JSDoc comment, and adds @publicdocs
- This is what generate-docs v2 scans to produce generated_docs_data_v2.json
Test plan
version) have empty interfaces with @publicdocs in v2