Skip to content

feat: update troubleshooting filters and navigation#1243

Merged
ricardoaerobr merged 6 commits into
mainfrom
EDU-17951-troubleshooting-filters-ui
May 26, 2026
Merged

feat: update troubleshooting filters and navigation#1243
ricardoaerobr merged 6 commits into
mainfrom
EDU-17951-troubleshooting-filters-ui

Conversation

@ricardoaerobr
Copy link
Copy Markdown
Contributor

What is the purpose of this pull request?

Summary

This PR updates the Troubleshooting experience in devportal to support the new troubleshooting taxonomy from dev-portal-content.

What changed

  • Updated troubleshooting data parsing to read:
    • domainFilters
    • symptomFilters
  • Kept a composed tags fallback for compatibility where needed
  • Updated the Troubleshooting filter modal to show two filter groups:
    • Type
    • Area
  • Updated troubleshooting cards to render:
    • symptom filters in blue
    • domain filters in gray
  • Updated troubleshooting path discovery to ignore taxonomy/helper docs in the root of docs/troubleshooting
  • Updated public/navigation.json Troubleshooting categories to the new structure:
    • API and integrations
    • VTEX IO and app development
    • Storefront
    • Content Management (CMS)
    • Checkout and shopping experience
    • Analytics and data collection

Dependency

This PR depends on the corresponding dev-portal-content branch:

  • EDU-17951-Enable-tagging-system-for-Troubleshooting-(Developer-Portal)

That branch already includes the final strategy alignment, so this UI implementation is based on the finalized taxonomy.

Notes

  • An unrelated local change in RapiDoc was intentionally not included

Validation

  • Verified the new Troubleshooting navigation structure is present in public/navigation.json
  • Verified the page logic now filters by separate symptom and domain dimensions
  • Verified troubleshooting taxonomy helper docs are not treated as troubleshooting articles
  • TypeScript validation was not completed locally because the environment is missing required type definitions for node and cypress

What problem is this solving?

How should this be manually tested?

Screenshots or example usage

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Requires change to documentation, which has been updated accordingly.

@ricardoaerobr ricardoaerobr self-assigned this Apr 28, 2026
@netlify
Copy link
Copy Markdown

netlify Bot commented Apr 28, 2026

Deploy Preview for elated-hoover-5c29bf ready!

Name Link
🔨 Latest commit 3315073
🔍 Latest deploy log https://app.netlify.com/projects/elated-hoover-5c29bf/deploys/6a1591a42354360008587e07
😎 Deploy Preview https://deploy-preview-1243--elated-hoover-5c29bf.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link
Copy Markdown

@github-actions github-actions Bot left a comment

Choose a reason for hiding this comment

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

This pull request does not contain a valid label. Please add one of the following labels: ['release-no', 'release-auto', 'release-patch', 'release-minor', 'release-major']

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 28, 2026

A total of 32 tests failed!

API guides documentation page

1 failing tests:

  • Check if the sidebar collapse button works (/docs/guides)

API reference documentation page

1 failing tests:

Status of documentation pages

30 failing tests:

  • Checks page docs/guides/update-cart-items
  • Checks page docs/guides/master-data
  • Checks page docs/guides/cardholder-document-configuration
  • Checks page docs/guides/hide-anonymous-customer-option
  • Checks page docs/guides/hide-anonymous-customer-option
  • Checks page docs/guides/hide-anonymous-customer-option
  • Checks page docs/api-reference/profile-system
  • Checks page docs/api-reference/profile-system
  • Checks page docs/api-reference/profile-system
  • Checks page docs/api-reference/profile-system
  • Checks page docs/api-reference/profile-system#get-/api/storage/profile-system/prospects/-prospectId-/unmask
  • Checks page docs/guides/seller-portal-edition-app
  • Checks page docs/guides/seller-portal-edition-app
  • Checks page docs/guides/seller-portal-edition-app
  • Checks page docs/guides/controlling-access-to-app-resources
  • Checks page docs/apps/vtex.b2b-organizations
  • Checks page docs/apps/vtex.b2b-organizations
  • Checks page docs/apps/vtex.b2b-organizations
  • Checks page docs/apps/vtex.b2b-organizations
  • Checks page docs/guides/cart-and-checkout
  • Checks page docs/guides/cart-and-checkout
  • Checks page docs/guides/cart-and-checkout
  • Checks page docs/guides/cart-and-checkout
  • Checks page updates/release-notes/2026-04-10-delivery-promise-suggestions-api-headless-integration
  • Checks page updates/release-notes/decimal-place-customization
  • Checks page updates/release-notes/addtocart-event-with-inaccurate-currency-value
  • Checks page updates/release-notes/addtocart-event-with-inaccurate-currency-value
  • Checks page updates/release-notes/addtocart-event-with-inaccurate-currency-value
  • Checks page updates/release-notes/payment-connector-homologation-freeze-in-preparation-for-black-friday
  • Checks page updates/release-notes/payment-connector-homologation-freeze-in-preparation-for-black-friday

For more information, open the cypress action summary page.

@ricardoaerobr ricardoaerobr added the release-no No release bump label Apr 28, 2026
Copy link
Copy Markdown
Contributor

@carolinamenezes carolinamenezes left a comment

Choose a reason for hiding this comment

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

Rodar o prettier para evitar erros no deploy

ricardoaerobr and others added 2 commits May 20, 2026 12:25
Fix formatting to resolve deploy lint/prettier checks.

Co-authored-by: Cursor <cursoragent@cursor.com>
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 20, 2026

Copy link
Copy Markdown
Contributor

@carolinamenezes carolinamenezes left a comment

Choose a reason for hiding this comment

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

LGTM!

@ricardoaerobr ricardoaerobr merged commit bee2388 into main May 26, 2026
4 of 7 checks passed
@ricardoaerobr ricardoaerobr deleted the EDU-17951-troubleshooting-filters-ui branch May 26, 2026 14:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

release-no No release bump

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants