docs: add search rules documentation

[YoEight]

Description

Add documentation for the (dynamic) search rules experimental feature.

Checklist

For internal Meilisearch team member only:

• I checked and followed our internal guidelines
• ⚠️ I updated the code samples according to our internal guidelines

For external maintainers

• Did you use any AI tool while implementing this PR (code, tests, docs, etc.)? If yes, disclose it in the PR description and describe what it was used for. AI usage is allowed when it is disclosed.
• Have you made sure that the title is accurate and descriptive of the changes?

Summary by CodeRabbit

• New Features

  • Introduced search rules experimental feature enabling document pinning at specified result positions based on query and time-based conditions.

• Documentation

  • Added comprehensive search rules documentation: overview, getting started guide, pinning patterns, advanced behavior, and API reference.
  • Updated experimental features overview to include search rules.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
meilisearch-documentation	🟢 Ready	View Preview	Apr 12, 2026, 8:31 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[coderabbitai]

📝 Walkthrough

Walkthrough

This PR adds comprehensive documentation for a new "Search rules" experimental feature, enabling users to pin specific documents at fixed result positions based on query and/or time-based conditions. Documentation includes overview, getting started workflow, common patterns, API reference, advanced behavior specifications, and navigation updates.

Changes

Cohort / File(s)	Summary
Search Rules Documentation capabilities/search_rules/overview.mdx, capabilities/search_rules/getting_started.mdx, capabilities/search_rules/how_to/pinning_patterns.mdx, capabilities/search_rules/advanced/pinning_behavior.mdx	Four new documentation pages introducing search rules: overview of functionality and constraints, step-by-step getting started guide with API workflows, practical pinning patterns and examples, and detailed specifications of pinning behavior (deduplication, filter application, pagination consistency).
Documentation Updates capabilities/overview.mdx, resources/help/experimental_features_overview.mdx	Updated existing documentation to reference search rules—added "Search rules" capability card to main overview and listed feature in experimental features table.
Navigation Configuration config/navigation.json	Added "Search rules" section under Capabilities with navigation links to overview, getting started guide, and nested how-to and advanced documentation subgroups.

Estimated Code Review Effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

📌 Through search results the rabbit does bound,
Pinning treasured documents, round and round,
With queries and time-windows as the key,
Rules guide the results in harmony,
A curator's delight, 'tis plain to see! 🐰

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'docs: add search rules documentation' directly and clearly describes the main change—adding comprehensive documentation for the search rules feature.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch dsr

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

🧹 Nitpick comments (1)

capabilities/search_rules/advanced/pinning_behavior.mdx (1)

31-31: Rephrase to avoid meta-language in user-facing documentation.

The sentence "Describe it as a case-insensitive literal substring match..." sounds like internal guidance for documentation writers rather than direct explanation to users.

✍️ Suggested rewording

-The query condition `contains` is a strict substring match. Describe it as a case-insensitive literal substring match, not as fuzzy, semantic, or pattern-aware matching.
+The query condition `contains` performs a case-insensitive literal substring match. It is not a fuzzy, semantic, or pattern-aware match.

As per coding guidelines: Prefer short, direct sentences and avoid jargon when a simpler term exists in documentation.

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In `@capabilities/search_rules/advanced/pinning_behavior.mdx` at line 31, The
sentence currently uses meta-documentation language; update the user-facing
description of the query operator `contains` to a short, direct phrase such as
"Performs a case-insensitive literal substring match" (avoid words like
"describe" or internal guidance), and replace the existing sentence so the docs
state plainly what `contains` does without jargon or meta-instructions.

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@capabilities/search_rules/advanced/pinning_behavior.mdx`:
- Line 31: The sentence currently uses meta-documentation language; update the
user-facing description of the query operator `contains` to a short, direct
phrase such as "Performs a case-insensitive literal substring match" (avoid
words like "describe" or internal guidance), and replace the existing sentence
so the docs state plainly what `contains` does without jargon or
meta-instructions.

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 8f7b2d68-df5f-436f-b8d8-7c931e56f276

📥 Commits

Reviewing files that changed from the base of the PR and between 04e9e1f and 732ee7b.

📒 Files selected for processing (8)

• capabilities/overview.mdx
• capabilities/search_rules/advanced/pinning_behavior.mdx
• capabilities/search_rules/getting_started.mdx
• capabilities/search_rules/how_to/pinning_patterns.mdx
• capabilities/search_rules/overview.mdx
• capabilities/search_rules/reference.mdx
• config/navigation.json
• resources/help/experimental_features_overview.mdx