Skip to content

Update outdated documentation links#1462

Open
qdequele wants to merge 1 commit intomainfrom
fix/update-documentation-links
Open

Update outdated documentation links#1462
qdequele wants to merge 1 commit intomainfrom
fix/update-documentation-links

Conversation

@qdequele
Copy link
Member

@qdequele qdequele commented Mar 20, 2026

Summary

  • Updated meilisearch.com/docs links to match the current sitemap URLs
  • Old paths were either redirecting (308) or returning 404s

Test plan

  • Verify all updated links resolve correctly (no 404s or extra redirects)
  • No code logic changed — only documentation URLs

Summary by CodeRabbit

  • Documentation
    • Updated and corrected all documentation links to align with the latest Meilisearch documentation structure.
    • Fixed FAQ navigation links and getting-started guide references.
    • Corrected API documentation links to point to updated endpoint paths.
    • Ensured all documentation anchors and resource paths are current for improved user navigation.

@changeset-bot
Copy link

changeset-bot bot commented Mar 20, 2026

⚠️ No Changeset found

Latest commit: 0043f62

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@coderabbitai
Copy link

coderabbitai bot commented Mar 20, 2026

📝 Walkthrough

Walkthrough

Documentation link updates across multiple README and CHANGELOG files to align with restructured Meilisearch documentation paths. Links now point to new endpoint locations like search-with-post and updated documentation structure under getting_started, basic_security, and resources.

Changes

Cohort / File(s) Summary
Autocomplete Client README
packages/autocomplete-client/README.md
Updated FAQ navigation link, Primary key documentation reference, meiliSearchParams parameter URLs from /search? to /search/search-with-post? endpoints, and Search metadata note link to authorization page.
Instant Meilisearch Documentation
packages/instant-meilisearch/CHANGELOG.md, packages/instant-meilisearch/README.md
Updated ranking score threshold link in CHANGELOG. In README: FAQ path to /docs/learn/resources/faq, self-hosted installation path, security references from master_api_keys to basic_security, index references to getting_started/indexes, and multiple API anchor targets for search parameters, cropping, snippets, and ranking features.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Poem

🐰 A hopping joy through docs so fine,
Old links now shine with paths divine,
Search-with-post and realms anew,
FAQ finds its home, tried and true,
Meilisearch maps lead us right,
Documentation takes its flight!

🚥 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 accurately captures the main purpose of the changeset: updating documentation links across multiple README and CHANGELOG files to point to current Meilisearch documentation URLs.
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 fix/update-documentation-links

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

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

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@packages/autocomplete-client/README.md`:
- Around line 233-246: Update the broken URL for the `hybrid` parameter in
README.md: locate the `hybrid` list item and change the link path segment from
"ai_powered_search" to "ai-powered-search" so the URL becomes
https://www.meilisearch.com/docs/learn/ai-powered-search/getting_started_with_ai_search;
ensure only that segment is modified and the rest of the link text and target
remain unchanged.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 613a55ad-c452-459f-8437-261a79153cea

📥 Commits

Reviewing files that changed from the base of the PR and between f1bdb92 and 0043f62.

📒 Files selected for processing (3)
  • packages/autocomplete-client/README.md
  • packages/instant-meilisearch/CHANGELOG.md
  • packages/instant-meilisearch/README.md

Comment on lines +233 to 246
- [`attributesToCrop`](https://www.meilisearch.com/docs/reference/api/search/search-with-post?utm_campaign=oss&utm_source=github&utm_medium=instant-meilisearch#attributes-to-crop)
- [`attributesToHighlight`](https://www.meilisearch.com/docs/reference/api/search/search-with-post?utm_campaign=oss&utm_source=github&utm_medium=instant-meilisearch#attributes-to-highlight)
- [`attributesToRetrieve`](https://www.meilisearch.com/docs/reference/api/search/search-with-post?utm_campaign=oss&utm_source=github&utm_medium=instant-meilisearch#attributes-to-retrieve)
- [`attributesToSearchOn`](https://www.meilisearch.com/docs/reference/api/search/search-with-post?utm_campaign=oss&utm_source=github&utm_medium=instant-meilisearch#customize-attributes-to-search-on-at-search-time)
- [`cropLength`](https://www.meilisearch.com/docs/reference/api/search/search-with-post?utm_campaign=oss&utm_source=github&utm_medium=instant-meilisearch#crop-length)
- [`cropMarker`](https://www.meilisearch.com/docs/reference/api/search/search-with-post?utm_campaign=oss&utm_source=github&utm_medium=instant-meilisearch#crop-marker)
- [`distinct`](https://www.meilisearch.com/docs/learn/relevancy/distinct_attribute)
- [`highlightPreTag`, `highlightPostTag`](https://www.meilisearch.com/docs/reference/api/search?utm_campaign=oss&utm_source=github&utm_medium=instant-meilisearch#highlight-tags)
- [`hybrid`](https://www.meilisearch.com/docs/learn/experimental/vector_search)
- [`matchingStrategy`](https://www.meilisearch.com/docs/reference/api/search?utm_campaign=oss&utm_source=github&utm_medium=instant-meilisearch#matching-strategy)
- [`showMatchesPosition`](https://www.meilisearch.com/docs/reference/api/search?utm_campaign=oss&utm_source=github&utm_medium=instant-meilisearch#show-matches-position)
- [`showRankingScore`](https://www.meilisearch.com/docs/reference/api/search?utm_campaign=oss&utm_source=github&utm_medium=instant-meilisearch#ranking-score)
- [`rankingScoreThreshold`](https://www.meilisearch.com/docs/reference/api/search?utm_campaign=oss&utm_source=github&utm_medium=instant-meilisearch#ranking-score-threshold)
- [`highlightPreTag`, `highlightPostTag`](https://www.meilisearch.com/docs/reference/api/search/search-with-post?utm_campaign=oss&utm_source=github&utm_medium=instant-meilisearch#highlight-tags)
- [`hybrid`](https://www.meilisearch.com/docs/learn/ai_powered_search/getting_started_with_ai_search)
- [`matchingStrategy`](https://www.meilisearch.com/docs/reference/api/search/search-with-post?utm_campaign=oss&utm_source=github&utm_medium=instant-meilisearch#matching-strategy)
- [`showMatchesPosition`](https://www.meilisearch.com/docs/reference/api/search/search-with-post?utm_campaign=oss&utm_source=github&utm_medium=instant-meilisearch#show-matches-position)
- [`showRankingScore`](https://www.meilisearch.com/docs/reference/api/search/search-with-post?utm_campaign=oss&utm_source=github&utm_medium=instant-meilisearch#ranking-score)
- [`rankingScoreThreshold`](https://www.meilisearch.com/docs/reference/api/search/search-with-post?utm_campaign=oss&utm_source=github&utm_medium=instant-meilisearch#ranking-score-threshold)

Copy link

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🔴 Critical

🧩 Analysis chain

🌐 Web query:

Do the following Meilisearch documentation URLs exist and return 200 status: https://www.meilisearch.com/docs/reference/api/search/search-with-post and https://www.meilisearch.com/docs/learn/ai_powered_search/getting_started_with_ai_search

💡 Result:

No, neither of the specified Meilisearch documentation URLs exist or return a 200 status. The first URL, https://www.meilisearch.com/docs/reference/api/search/search-with-post, does not appear in search results. Similar pages exist at https://meilisearch.com/docs/reference/api/search/search-with-post (without www) and https://www.meilisearch.com/docs/reference/api/search, but the exact URL with www and the full path is not found, indicating it likely returns 404. The second URL, https://www.meilisearch.com/docs/learn/ai_powered_search/getting_started_with_ai_search, does not exist. The correct path uses hyphens: https://www.meilisearch.com/docs/learn/ai-powered-search/getting_started_with_ai_search (result 6,17). The underscore version is not indexed, suggesting it redirects or 404s. Official docs confirm content at hyphenated paths, and llms.txt (result 10) lists /learn/ai_powered_search/getting_started_with_ai_search without www prefix matching exactly. No direct evidence of 200 for queried URLs; search engines index accessible 200 pages.

Citations:


🏁 Script executed:

sed -n '233,246p' packages/autocomplete-client/README.md

Repository: meilisearch/meilisearch-js-plugins

Length of output: 2295


Broken documentation link in hybrid parameter.

The hybrid parameter at line 241 links to https://www.meilisearch.com/docs/learn/ai_powered_search/getting_started_with_ai_search (with underscores), but the correct path uses hyphens: https://www.meilisearch.com/docs/learn/ai-powered-search/getting_started_with_ai_search. Update ai_powered_search to ai-powered-search.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@packages/autocomplete-client/README.md` around lines 233 - 246, Update the
broken URL for the `hybrid` parameter in README.md: locate the `hybrid` list
item and change the link path segment from "ai_powered_search" to
"ai-powered-search" so the URL becomes
https://www.meilisearch.com/docs/learn/ai-powered-search/getting_started_with_ai_search;
ensure only that segment is modified and the rest of the link text and target
remain unchanged.

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.

1 participant