Skip to content

[docs] Migration guide#3896

Merged
m-bert merged 31 commits intonextfrom
@mbert/docs-remove-enabled-root-view
Feb 3, 2026
Merged

[docs] Migration guide#3896
m-bert merged 31 commits intonextfrom
@mbert/docs-remove-enabled-root-view

Conversation

@m-bert
Copy link
Copy Markdown
Collaborator

@m-bert m-bert commented Dec 23, 2025

Description

This PR removes old migration guide and adds new one.

Test plan

Read docs 🤓

@m-bert m-bert marked this pull request as draft December 23, 2025 17:44
@m-bert m-bert added the Documentation Documentation change/enhancement label Jan 9, 2026
@m-bert m-bert changed the title [docs] Remove old migration guide [docs] Migration guide Jan 12, 2026
Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've extracted it to hook because as far as I remember similar logic was used in other places.

@m-bert m-bert marked this pull request as ready for review January 27, 2026 11:06
@m-bert m-bert requested a review from j-piasecki January 27, 2026 11:06
Copy link
Copy Markdown
Member

@j-piasecki j-piasecki left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think we're passing stateManager inside touch events any longer. This also needs to be mentioned.

Comment thread packages/docs-gesture-handler/docs/guides/upgrading-to-3.mdx Outdated
Comment thread packages/docs-gesture-handler/docs/guides/upgrading-to-3.mdx Outdated
Comment thread packages/docs-gesture-handler/docs/guides/upgrading-to-3.mdx Outdated
Comment thread packages/docs-gesture-handler/docs/guides/upgrading-to-3.mdx
Comment thread packages/docs-gesture-handler/docs/guides/upgrading-to-3.mdx Outdated
Comment thread packages/docs-gesture-handler/docs/guides/upgrading-to-3.mdx
Comment thread packages/docs-gesture-handler/docs/guides/upgrading-to-3.mdx Outdated
Comment thread packages/docs-gesture-handler/docs/guides/upgrading-to-3.mdx Outdated
Comment thread packages/docs-gesture-handler/docs/guides/upgrading-to-3.mdx Outdated
Comment thread packages/docs-gesture-handler/docs/guides/upgrading-to-3.mdx Outdated
Copilot AI review requested due to automatic review settings January 29, 2026 13:27
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the migration documentation for React Native Gesture Handler by removing outdated guides (upgrading to version 2 and migrating off RNGHEnabledRootView) and adding a comprehensive new guide for upgrading to version 3. The changes also include refactoring code formatting utilities and adding support for side-by-side code comparisons to better illustrate API changes.

Changes:

  • Removed old migration guides for RNGH 2 and RNGHEnabledRootView, as they are no longer relevant
  • Added comprehensive new migration guide documenting the transition from RNGH 2 to RNGH 3, covering gestures, relations, SVG usage, components, and type changes
  • Refactored code formatting logic into a reusable hook and created a new CodeComparison component for side-by-side code examples

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 6 comments.

Show a summary per file
File Description
packages/docs-gesture-handler/src/theme/MDXComponents/Details.js Updated MDX component to use item.type instead of deprecated item.props?.mdxType for MDX v3 compatibility
packages/docs-gesture-handler/src/hooks/useFormattedCode.tsx Extracted code formatting logic into a reusable custom hook for consistent code formatting across components
packages/docs-gesture-handler/src/css/overrides.css Added CSS styles for code comparison component and improved table styling in details sections
packages/docs-gesture-handler/src/components/CollapsibleCode/index.tsx Refactored to use the new useFormattedCode hook, removing duplicated formatting logic
packages/docs-gesture-handler/src/components/CodeComparison/index.tsx New component for displaying side-by-side code comparisons with headers, used throughout the migration guide
packages/docs-gesture-handler/docs/guides/upgrading-to-3.mdx Comprehensive new migration guide documenting all changes between RNGH 2 and RNGH 3 APIs
packages/docs-gesture-handler/docs/guides/upgrading-to-2.md Removed obsolete RNGH 2 migration guide
packages/docs-gesture-handler/docs/guides/troubleshooting.md Updated Discord link from Expo to Software Mansion and standardized quote style
packages/docs-gesture-handler/docs/guides/migrating-off-rnghenabledroot.md Removed obsolete RNGHEnabledRootView migration guide

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread packages/docs-gesture-handler/src/hooks/useFormattedCode.tsx Outdated
Comment thread packages/docs-gesture-handler/docs/guides/upgrading-to-3.mdx Outdated
Comment thread packages/docs-gesture-handler/docs/guides/upgrading-to-3.mdx Outdated
Comment thread packages/docs-gesture-handler/docs/guides/upgrading-to-3.mdx Outdated
Comment thread packages/docs-gesture-handler/src/components/CodeComparison/index.tsx Outdated
m-bert and others added 6 commits January 29, 2026 16:17
Co-authored-by: Andrzej Antoni Kwaśniewski <81448793+akwasniewski@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@m-bert
Copy link
Copy Markdown
Collaborator Author

m-bert commented Feb 3, 2026

I don't think we're passing stateManager inside touch events any longer. This also needs to be mentioned.

Of course I had to forget 😄 I added it in f1054dc

@m-bert m-bert merged commit 993f77f into next Feb 3, 2026
1 check passed
@m-bert m-bert deleted the @mbert/docs-remove-enabled-root-view branch February 3, 2026 09:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Documentation Documentation change/enhancement

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants