Refactor: Make generic pages framework-specific for coherent navigation #288
Conversation
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
added 3 commits
January 12, 2026 15:13
- Move generic documentation pages to framework-specific directories - Create redirects to maintain backward compatibility with old links - Update navigation structure and sidebar configuration - Convert pages to MDX format for better framework integration
- Changed links in the migration guides from absolute to relative paths for better consistency and accessibility. - Updated references in the migration guide from version 5.x to 6.x and from 6.x to 7.x to reflect the new link structure.
- Restored barcode-selection links in sidebar navigation for supported frameworks (iOS, Android, Cordova, React Native, Flutter, Capacitor, .NET iOS, .NET Android) - Moved barcode-selection under "Single Scanning" category for better organization - Added deprecation warnings to all barcode-selection intro and get-started pages recommending SparkScan or Barcode Capture API instead - Excluded barcode-selection from Web, Titanium, and Linux sidebars as these frameworks don't support it
raffaelefarinaro
assigned
raffaelefarinaro and
moritzhartmeier and unassigned
raffaelefarinaro
- Reintroduced the "Migration Guides" category in the sidebar for all supported frameworks (iOS, Android, Web, Cordova, React Native, Flutter, Capacitor, .NET). - Ensured that migration guides are consistently categorized and accessible across all platforms. - Maintained the collapsed state for better navigation experience.
moritzhartmeier
requested changes
Jan 16, 2026
moritzhartmeier
approved these changes
Jan 16, 2026
moritzhartmeier
requested changes
Jan 16, 2026
Member
There was a problem hiding this comment.
@raffaelefarinaro Taking my approval back as I just saw that the build job is reporting a lot of issues and it can't actually be built properly. I didn't see this locally because I guess I didn't build from scratch, not sure. See here.
added 12 commits
January 16, 2026 16:18
- Move generic documentation pages to framework-specific directories - Create redirects to maintain backward compatibility with old links - Update navigation structure and sidebar configuration - Convert pages to MDX format for better framework integration
- Changed links in the migration guides from absolute to relative paths for better consistency and accessibility. - Updated references in the migration guide from version 5.x to 6.x and from 6.x to 7.x to reflect the new link structure.
- Restored barcode-selection links in sidebar navigation for supported frameworks (iOS, Android, Cordova, React Native, Flutter, Capacitor, .NET iOS, .NET Android) - Moved barcode-selection under "Single Scanning" category for better organization - Added deprecation warnings to all barcode-selection intro and get-started pages recommending SparkScan or Barcode Capture API instead - Excluded barcode-selection from Web, Titanium, and Linux sidebars as these frameworks don't support it # Conflicts: # sidebars.ts
- Reintroduced the "Migration Guides" category in the sidebar for all supported frameworks (iOS, Android, Web, Cordova, React Native, Flutter, Capacitor, .NET). - Ensured that migration guides are consistently categorized and accessible across all platforms. - Maintained the collapsed state for better navigation experience.
…ed-barcode-scanning entries
…nces - Changed links in various SDK documentation files to use relative paths for better consistency and navigation. - Updated references to symbology properties across multiple files, ensuring all links point correctly to the intended resources. - Improved overall documentation clarity and accessibility for users.
…lude links to AI-powered features - Enhanced the deprecation warnings across various SDK documentation files for Barcode Selection. - Updated the warnings to reference new AI-powered features, providing users with clearer guidance on recommended alternatives. - Ensured consistency in messaging across Android, Flutter, iOS, and React Native documentation.
…avigation - Updated the Docusaurus configuration to refine redirect logic for the migration guide, ensuring no duplicate redirects are created. - Removed unnecessary redirect entries for root-level framework-agnostic pages, as they already have <Redirect> components in their MDX files. - Updated links in various SDK documentation files to point to GitHub sample repositories for better resource accessibility. - Ensured consistency in camera permission instructions across Android, Flutter, .NET, and React Native documentation.
…ion and clarity - Changed links in various SDK documentation files to use relative paths, enhancing consistency and accessibility. - Updated references to the SparkScan Workflow Options section across multiple SDKs to point to the correct advanced documentation. - Ensured that symbology references in migration guides are correctly linked for better user guidance.
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.
Made framework-specific the generic pages to keep a coherent navigation while still keeping the old links working by creating redirects.
Additional changes: