Skip to content

docs(gallery): move gallery documentation to v10 - #4627

Open
ShaneK wants to merge 1 commit into
major-9.0from
FW-7665
Open

docs(gallery): move gallery documentation to v10#4627
ShaneK wants to merge 1 commit into
major-9.0from
FW-7665

Conversation

@ShaneK

@ShaneK ShaneK commented Aug 10, 2026

Copy link
Copy Markdown
Member

What is the current behavior?

Currently, the v9 docs document the Gallery, which only exists on the next branch of ionic-framework and is not part of the v9 release. Separately, the component API tables are generated from @ionic/docs@8.8.9-dev.11781201980.1b6e8398, a dev build of a next branch commit, so every API page reports the next API surface rather than v9's. That build adds 193 properties that do not exist in v9, including theme on around 90 components plus shape, size, hue, expand, titlePlacement, and hideOnScroll. It also omits swipeGesture on ion-router-outlet and labelPlacement and justify on ion-select-option, which are real v9 properties, and still carries ion-picker-legacy, which v9 removed.

What is the new behavior?

The Gallery documentation moves to the new major-10.0 branch, so this removes docs/api/gallery.md, docs/api/gallery-item.md, static/usage/v9/gallery/, and static/img/demos/gallery/. Two edits from the original Gallery PRs are reverted along with it: the Grids sidebar category and its docs/components.md card go back to Grid, since the rename was only made to fit the Gallery into that family. The unrelated Inputs provide typo fix from #4484 is kept.

The API generation tag now points at 8.8.16-dev.11784913436.1a334b43, built from the major-9.0 branch of ionic-framework. That drops the 193 properties, restores the three v9 properties that were missing, and clears the stale ion-picker-legacy data.

Does this introduce a breaking change?

  • Yes
  • No

Other information

Verified against the generated output that no component reports theme, that titlePlacement and hideOnScroll are gone, that no Gallery pages generate, and that labelPlacement on ion-select-option is still present. The four remaining broken-link warnings are in versioned_docs/version-v7/index.md, which this branch does not touch.

Companion branch: major-10.0, which archives v9 into versioned_docs/version-v9/ and keeps the Gallery as v10 content.

When this lands, major-9.0 needs merging into major-10.0 once, resolving in favour of v10. A plain merge deletes static/img/demos/gallery/, drops the Gallery entries from sidebars.js, and reverts the docs/components.md card without raising a conflict on any of the three, because those hunks only change on this side. Everything else conflicts loudly. Doing that merge once makes this commit an ancestor of major-10.0 so later syncs stay clean.

Previews:

@ShaneK
ShaneK requested a review from a team as a code owner August 10, 2026 16:22
@ShaneK
ShaneK requested review from BenOsodrac and removed request for a team August 10, 2026 16:22
@vercel

vercel Bot commented Aug 10, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
ionic-docs Ready Ready Preview Aug 10, 2026 4:31pm

Request Review

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