Skip to content

fix(nx-dev): improve docs search ranking and metrics#34992

Merged
barbados-clemens merged 4 commits into
masterfrom
cu/DOC-408-search
Mar 24, 2026
Merged

fix(nx-dev): improve docs search ranking and metrics#34992
barbados-clemens merged 4 commits into
masterfrom
cu/DOC-408-search

Conversation

@barbados-clemens
Copy link
Copy Markdown
Contributor

@barbados-clemens barbados-clemens commented Mar 24, 2026

Current Behavior

  • Searching for a framework (e.g. "nestjs", "vite", "angular") returns random pages that mention the term instead of the plugin introduction page.
  • The launch templates page is too long impacting word saturation
  • Search event tracking uses wrong event

Expected Behavior

  • Technology introduction pages rank first or second when searching for their framework name.
  • Launch templates are split into a focused reference page and a separate examples page, both cross-linked.
  • Use correct search event and track user selected item from query
  • enforce usage of pagefind filter names in content collection schemas

Fixes DOC-408

search_query -> search + search_term
now include picked item from a search via select_content
page was too long and impacting search perf for launch template specific
items
when searching for framework or plugin the pages should be in top 2
results.

other pages tested don't show any other impact (as expected):
cli references, nx cloud setups, launch templates, dependencies
management etc

will keep iterating once more metrics come in
@netlify
Copy link
Copy Markdown

netlify Bot commented Mar 24, 2026

Deploy Preview for nx-docs ready!

Name Link
🔨 Latest commit 642bab9
🔍 Latest deploy log https://app.netlify.com/projects/nx-docs/deploys/69c2c84db6f9580008cfc248
😎 Deploy Preview https://deploy-preview-34992--nx-docs.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.

@netlify
Copy link
Copy Markdown

netlify Bot commented Mar 24, 2026

Deploy Preview for nx-dev ready!

Name Link
🔨 Latest commit 642bab9
🔍 Latest deploy log https://app.netlify.com/projects/nx-dev/deploys/69c2c84dfd77d00008def86d
😎 Deploy Preview https://deploy-preview-34992--nx-dev.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.

@barbados-clemens barbados-clemens changed the title fix(nx-dev): improve docs search ranking and split launch templates page fix(nx-dev): improve docs search ranking and metrics Mar 24, 2026
@nx-cloud
Copy link
Copy Markdown
Contributor

nx-cloud Bot commented Mar 24, 2026

View your CI Pipeline Execution ↗ for commit 642bab9

Command Status Duration Result
nx affected --targets=lint,test,build,e2e,e2e-c... ✅ Succeeded 7m 19s View ↗
nx run-many -t check-imports check-lock-files c... ✅ Succeeded 6s View ↗
nx-cloud record -- pnpm nx conformance:check ✅ Succeeded 7s View ↗
nx build workspace-plugin ✅ Succeeded 1m 43s View ↗
nx-cloud record -- nx format:check ✅ Succeeded 2s View ↗
nx-cloud record -- nx sync:check ✅ Succeeded <1s View ↗

☁️ Nx Cloud last updated this comment at 2026-03-24 17:35:52 UTC

@barbados-clemens barbados-clemens self-assigned this Mar 24, 2026
@barbados-clemens barbados-clemens marked this pull request as ready for review March 24, 2026 17:25
@barbados-clemens barbados-clemens requested a review from a team as a code owner March 24, 2026 17:25
@barbados-clemens barbados-clemens enabled auto-merge (squash) March 24, 2026 17:33
@barbados-clemens barbados-clemens merged commit 34b8256 into master Mar 24, 2026
28 checks passed
@barbados-clemens barbados-clemens deleted the cu/DOC-408-search branch March 24, 2026 18:05
FrozenPandaz pushed a commit that referenced this pull request Mar 26, 2026
## Current Behavior

- Searching for a framework (e.g. "nestjs", "vite", "angular") returns
random pages that mention the term instead of the plugin introduction
page.
- The launch templates page is too long impacting word saturation
- Search event tracking uses wrong event

## Expected Behavior

- Technology introduction pages rank first or second when searching for
their framework name.
- Launch templates are split into a focused reference page and a
separate examples page, both cross-linked.
- Use correct search event and track user selected item from query
- enforce usage of pagefind filter names in content collection schemas

Fixes DOC-408

(cherry picked from commit 34b8256)
@github-actions
Copy link
Copy Markdown
Contributor

This pull request has already been merged/closed. If you experience issues related to these changes, please open a new issue referencing this pull request.

@github-actions github-actions Bot locked as resolved and limited conversation to collaborators Mar 30, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants