Skip to content

Samples review#2478

Open
mateuszbartosik wants to merge 4 commits into
ravendb:mainfrom
mateuszbartosik:samples-review
Open

Samples review#2478
mateuszbartosik wants to merge 4 commits into
ravendb:mainfrom
mateuszbartosik:samples-review

Conversation

@mateuszbartosik
Copy link
Copy Markdown
Contributor

Issue link

https://issues.hibernatingrhinos.com/issue/RDoc-3888

Additional description

  • Tags (both for Samples and Guides cards) will display items based on the container width. Whenever there's an overflow coming, a clickable tag with +X more will show up. Once clicked, everything will be expanded.
  • A new order.yml file responsible for ordering will be implemented. It will allow to manually adjust the order, with a fallback of items not specified being sorted alphabetically.

Type of change

  • Content - docs
  • Content - cloud
  • Content - guides
  • Content - start pages/other
  • New docs feature (consider updating /templates or readme)
  • Bug fix
  • Optimization
  • Other

Changes in docs URLs

  • No changes in docs URLs
  • Articles are restructured, URLs will change, mapping is required (update /scripts/redirects.json file, set Documents Moved PR label)

Changes in UX/UI

  • No changes in UX/UI
  • Changes in UX/UI (include screenshots and description)
image

Add OverflowTagRow, a reusable row that measures tag widths via a
ResizeObserver and collapses overflow into a "+X more" pill, keeping each
category row on a single line and adapting to the card's own width. Clicking
the pill expands the row.

In SampleCard, render the Challenges & Solutions and Features rows through
OverflowTagRow and move selected (matching) tags to the front so the reason a
card matched stays visible after filtering.
Generalize OverflowTagRow to also handle permalink-based tags and move it to
components/Common so it can be shared. Use it in CardWithImage (the guide grid
cards, homepage use cases, and tag-doc list) in place of the fixed two-tag
useTagLimit, so tags fill the available width on a single line before
collapsing into a width-aware "+X more" pill.
Introduce samples/order.yml as the single source of truth for the /samples
hub ordering and have recent-samples-plugin sort indexed samples by it. Listed
samples render first in the given order; any unlisted sample follows,
sorted alphabetically by title.
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.

2 participants