Context: Issue #2191 reports that the `RichText` component's `routeHandler` method in `@sitecore-jss/sitecore-jss-vue` constructs the navigation URL using only `target.pathname` and `target.hash`, omitting `target.search`. This causes query parameters to be stripped during client-side navigation. Since JSS Vue has no Content SDK equivalent and Vue is an archive-candidate package, investing in a code fix is not justified. However, affected teams need a documented workaround.
Steps:
1. Add a "Known Issues" section to the JSS repository README (or create a `KNOWN-ISSUES.md`)
2. Document issue #2191 with a clear description of the symptom
3. Provide a workaround: teams should override the `routeHandler` prop on the `RichText` component to include `target.search` in the constructed URL (e.g., `const url = target.pathname + target.search + target.hash`)
4. Note that JSS Vue will not receive further feature fixes and recommend evaluating Content SDK (Next.js) for new projects
Acceptance criteria:
Known issue documented with reproduction steps and workaround
Workaround code snippet included
Documentation indicates JSS Vue is in archive/EOL status
Risks: None identified.