Commit Graph
35 Commits
Author SHA1 Message Date
István Zoltán Szabó f2ce2fc84b Add weight to Bulk Upload page. 2026-07-28 09:23:03 +02:00
Abdon Pijpelink 10b0ef80b6 Multitenancy diagram clarification (#2533) 2026-07-24 14:54:11 +02:00
Abdon Pijpelink 45f19f30ee Break up "Distributed Deployment" page into new "Scaling & Resilience" section (#2491)
* Add new Scaling landing page under Operations

Introduces a Scaling section with vertical vs. horizontal scaling
guidance and failover best practices, linking out to detail pages.

* Add new Vertical Scaling page

Dedicated how-to guidance for resizing existing nodes: when to scale
vertically, RAM sizing formulas, and Cloud/self-hosted resize steps.

* Add new Horizontal Scaling and Resilience page

Covers Raft consensus, the replication model, consistency guarantees,
Multi-AZ, and the resilience terminology used elsewhere in the docs.

* Move Distributed Deployment under Scaling and update all incoming links

Moves distributed_deployment.md into the new scaling/ section, trims
its Raft/Replication/Consistency intros into cross-links to the new
Horizontal Scaling and Resilience page, adds Multi-AZ and single-replica
cross-link callouts in the Cloud docs, rewrites all internal references
across ~30 files to the new canonical path instead of relying on
aliases, and applies Title Case to Distributed Deployment's headers.

* Split Resilience out of Horizontal Scaling and Resilience

Adds a dedicated Resilience page covering fault tolerance, Multi-AZ,
resilience terminology, and failover best practices (moved from the
Scaling landing page). Horizontal Scaling is retitled and scoped to
the underlying mechanics: Raft consensus, replication, and consistency.

* Reorganize Horizontal Scaling's structure

Moves "How Many Qdrant Nodes Should I Run?" from Distributed Deployment
into Horizontal Scaling, adds a conceptual Sharding section, and
reorders Sharding/Replication/Raft Consensus/Consistency. Moves the
remaining conceptual content out of Distributed Deployment: Temporary
Node Failure to Resilience, Error Handling folded into Replication,
sharding heuristics folded into Sharding, and the Consensus
Checkpointing explanation folded into Raft Consensus.

* Rename Scaling section to Scaling & Resilience

Renames the section and restructures the landing page: the vertical-
vs-horizontal decision is now purely about scaling, with a dedicated
Resilience section covering fault tolerance through sharding and
multi-node deployments.

* Polish Vertical Scaling and Resilience page content

Reframes Vertical Scaling's "What Not to Do" as positive "Best
Practices". Reworks Resilience's structure: moves the uptime/data-
integrity terminology into the intro as three distinct aspects of
resilience, and renames "How Resilience Works" to "Setting Up a
Resilient Qdrant Cluster".

* Add diagrams illustrating sharding and replication

Adds cluster diagrams to the Sharding and Replication sections on
Horizontal Scaling to make the shard/replica layout easier to follow.

* Add new Node Failure Recovery page

Extracts the node failure recovery scenarios out of Distributed
Deployment into their own page, with each bolded sub-header converted
to a proper heading, and links updated across Resilience and the
Scaling landing page.

* Add new Consistency Guarantees page

Extracts write consistency factor, read consistency, and write
ordering out of Distributed Deployment into their own page, positioned
after Distributed Deployment.

* Add new "Deploy Behind a Load Balancer" section

Explains why a load balancer is needed in front of a multi-node
Qdrant cluster: avoiding a single point of failure at the entry point
and making sure replicas on every node actually serve reads.

* Add new "Rebalancing" section

Documents how Qdrant Cloud automatically rebalances shards across
nodes, as its own subsection under Sharding.

* Rewrite Multi-AZ vs. Replication Factor as Multi-AZ Deployments

Defines an availability zone on first use, explains why multi-AZ
deployments guard against a zone going down, clarifies that Qdrant
Cloud is zone-aware once enabled, and that self-hosted deployments
need to place and move replicas across zones manually.

* Restructure node-count guidance into One/Two/Three-or-more Node subsections

Splits "How Many Qdrant Nodes Should I Run?" into three subsections
and drops the "balanced" framing for two nodes: it states plainly
that two nodes give more capacity without true high availability.

* Add new "Which Configuration Is Right for You?" section

Summarizes the one/two/three-or-more node tradeoffs in one place
right after the detailed breakdown.

* Add explicit _redirects entry for legacy distributed_deployment URL

Closes the redirect chain: the existing /guides/ and /operations/
legacy rules both terminate at /documentation/distributed_deployment/,
which previously had no explicit _redirects entry and only resolved
via the Hugo alias meta-refresh page.

* Fix all incoming links to Distributed Deployment and pages under Scaling

Repoints two same-page anchors in distributed_deployment.md that broke
when Write Ordering moved to Consistency Guarantees, and one link in
cloud/create-cluster.md that broke when a Resilience heading was
reworded.

* Update time-based sharding diagram and restructure section

* Fix a couple of broken links

* Move 'Consensus Checkpointing' to 'Node Failure Recovery' page
2026-07-16 09:11:58 +02:00
Dylan Couzon d43d4a5f78 Merge pull request #2487 from qdrant/random-shape-payloads
add tutorial: Indexing Payloads of Random Shape
2026-07-09 09:51:33 -04:00
1c751faf3d Default rescoring docs are outdated (#2484)
* update default rescoring config for turboquant

* Update FAQ too

* Revert changes to qdrant-landing/package-lock.json

---------

Co-authored-by: Nathan LeRoy <nleroy917@users.noreply.github.com>
Co-authored-by: Abdon Pijpelink <abdon.pijpelink@qdrant.com>
2026-07-09 09:37:04 +02:00
Dylan Couzon 5d19e6cdd0 add tutorial 2026-07-08 17:08:58 -04:00
Abdon Pijpelink 757767919b Add 'Mitigate Read-Write Contention' section to the bulk upload guide (#2469)
* Change bulk upload from tutorial into guide

* Add 'Mitigate Read-Write Contention' section to bulk upload guide

* Update meta descriptions
2026-07-06 10:02:00 +02:00
István Zoltán Szabó f96721efda Add blue-green cluster deployment tutorial. 2026-06-22 15:17:56 +02:00
Abdon PijpelinkandClaude Sonnet 4.6 18b17916b5 Points page typos etc (#2423)
* fix: correct typos and grammar in points documentation

Fix capitalization of "Qdrant", missing articles, subject-verb agreement,
plural agreement, a wrong noun ("vectors" → "points"), and several
awkward phrasings throughout the page.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* fix: convert all headings to title case in points documentation

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-11 13:11:35 +02:00
István Zoltán SzabóandAbdon Pijpelink 079e4e6d9d Apply suggestions from code review
Co-authored-by: Abdon Pijpelink <abdon.pijpelink@qdrant.com>
2026-06-10 10:38:36 +02:00
István Zoltán Szabó cfa0c59bf5 Fix typos in docs. 2026-06-10 10:02:20 +02:00
István Zoltán Szabó 8f50b217a8 Merge pull request #2393 from qdrant/szabosteve/initial-docs-review
Fix typos in docs
2026-06-02 13:39:35 +02:00
István Zoltán Szabó f580f6007d Fix typos in docs. 2026-06-02 11:53:06 +02:00
Abdon Pijpelink 0ae7f06cc2 Remove last mention of RocksDB from the docs 2026-05-26 09:50:53 +02:00
Abdon Pijpelink 04e3e0bb1d Add named vectors scenario to embedding migration tutorial (#2348)
* Initial commit

* Edits

* Update FAQ

* Edits

* Mention required versions
2026-05-26 09:38:24 +02:00
Mohamed Arbi b889e19117 docs: fix typos and improve clarity in quantization/turboQuant docs (#2371) 2026-05-26 09:36:46 +02:00
Abdon PijpelinkandTim Visée cf94245089 Increase payload indexing advice visibility (#2360)
* Add new 'Create a Payload Index' section

* Add indexing tip to low latency search, search, and filtering docs

* Add bash code snippet

* Edits

* Update qdrant-landing/content/documentation/manage-data/indexing.md

Co-authored-by: Tim Visée <tim@visee.me>

---------

Co-authored-by: Tim Visée <tim@visee.me>
2026-05-20 10:05:33 +02:00
Dylan Couzon 1d36116d77 Merge pull request #2334 from qdrant/hybrid-search-gap-2
Multi-representation search tutorial + supporting doc cross-links
2026-05-15 14:17:28 -04:00
Tim Visée db67ab203f Merge pull request #2263 from qdrant/correct-param-index-note
Correct parameterized index note
2026-05-15 17:46:49 +02:00
Abdon Pijpelink 1a0f06231c Add links to TurboQuant article (#2354)
* Add links to TQ article

* Add link to articles for other quantization methods

* Update TQ article preview images
2026-05-15 16:26:18 +02:00
kanungle b013a0b2e4 Merge branch 'master' into meta-descriptions 2026-05-12 15:44:44 -07:00
46e81449a8 Add TurboQuant quantization documentation (v1.18.0) (#2313)
* Add TurboQuant quantization documentation (v1.18.0)

Adds a new TurboQuant section to the quantization guide covering the
four encoding options (bits1/bits1_5/bits2/bits4), automatic asymmetric
quantization, distance metric support, and the automatic TQ+ precision
enhancement for sealed segments. Updates the comparison table and
method-selection guidance to recommend TurboQuant over Binary and
Scalar Quantization for new collections. Adds HTTP-only snippets for
basic setup and explicit bit-depth selection.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Consistently use title case for headers

* Restructure doc to lead with TurboQuant

* Clarify rescoring

* Edits

* Soften TQ advice

* Updates

* Fix

* Apply suggestions from code review

Co-authored-by: Jojii <15957865+JojiiOfficial@users.noreply.github.com>

* Review feedback

* Add Go/Java/C# code snippets

* Add list of 4 quantization methods to introduction

* Review feedback

* Stronger advice for TQ4

* Add Python snippets

* Add Rust snippets

* Add TS snippets

* Update recommendation table

* Update production checklist

* Remove link to article

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-authored-by: Jojii <15957865+JojiiOfficial@users.noreply.github.com>
2026-05-11 08:13:03 +02:00
Dylan CouzonandClaude Opus 4.7 bb877b23f7 add cross-links from search and vectors docs to multi-rep tutorial
- hybrid-queries: see-also link at end of grouping section
- vectors: clarify MaxSim returns one combined score and point to named vectors + tutorial
- text-search: BM25 short-field calibration note plus BM25F workaround pointer

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-05 19:10:24 -04:00
kanungle deb8b5533f initial commit; Claude generated SEO descriptions 2026-05-01 09:07:30 -07:00
Abdon Pijpelink 10b98c3ca2 Docs for adding/removing named vectors (#2282)
* Initial commit

* Switch to title case for Collections page

* Move to Collections page

* One more clarification

* Update section title
2026-04-30 09:03:48 +02:00
Abdon Pijpelink b23b94b3c5 "Things to Check Before Taking Qdrant into Production" guide (#2219)
* Update Qdrant logo in tradeoff image

* Add production checklist

* Add payload indexing

* Review feedback

* Review feedback

* Small edits

* Fix links
2026-04-21 14:36:33 +02:00
kanungleandAbdon Pijpelink 544708f293 Restructure Docs - Stage 4a (#2280)
* create Develop and Deploy tabs; move Operations; re-weight pages

* move capacity planning page; create section dropdown content

* added aliases to frontmatter

* update link references to new canonical links; maintain anchoring

* address remaining link issues and errors

* fix outlier tutorial reference issue

* Treat 'develop' and 'deploy' as a unified search space

* fix some frontmatter aliases

* add section header redirects

* fix 'Operations' redirect to go to 'Deploy' tab

* update redirects file for * pattern

* add :splat to redirect references

* Add wildcard to each entry in _redirects file

---------

Co-authored-by: Abdon Pijpelink <abdon.pijpelink@qdrant.com>
2026-04-20 18:03:45 +02:00
timviseeandAbdon Pijpelink c0f85b6ff7 Apply review suggestion
Co-Authored-By: Abdon Pijpelink <abdon.pijpelink@qdrant.com>
2026-04-08 17:01:48 +02:00
timvisee e21538c473 Also update main documentation page 2026-04-08 16:59:34 +02:00
Abdon Pijpelink 5f46ac8474 Switch to server-side 301s for moved pages (#2243)
* 200 rewrites for moved pages

* Remove unnecessary aliases

* Match both the directory path and any files within it

* Change into 301s
2026-04-01 17:43:55 +02:00
1a40961d62 fix: linkchecker include filter port mismatch (#2242)
* initial commit; fixed anchor links on internal docs pages

* add back in absolute paths for links in code comments

* fix: update linkchecker include filter to match server port 1314

PR #1629 changed the Hugo server to port 1314 but forgot to update
the --include filter, which still matched port 1313. This caused all
links to be excluded, making the checker a no-op (0 checked, 82277 excluded).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Fix url rewrite regex so images are not impacted

* Fix links from non-documentation pages

* Fix broken links

* more broken links

* more broken links

* broken link

* Add srcset width descriptor to .lycheeignore

* Ignore URLs that contain a % character

* Anchor regex so it matches the entire URL

---------

Co-authored-by: kanungle <neil.kanungo@gmail.com>
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-authored-by: Abdon Pijpelink <abdon.pijpelink@qdrant.com>
2026-03-30 17:21:32 +02:00
Abdon Pijpelink 063b0c7111 Update default value of indexing_threshold (#2236) 2026-03-27 13:17:50 +01:00
Mohamed ArbiandAbdon Pijpelink c0db45ed8f Fix Docs : minor grammar fixes (#2218)
* fix(docs): fix typos and some links in documentation

* fix(docs): correct typo in filtering.md

* Update qdrant-landing/content/documentation/headless/snippets/inference/jinaai-upsert/generated/typescript.md

Co-authored-by: Abdon Pijpelink <abdon.pijpelink@qdrant.com>

* Update qdrant-landing/content/documentation/headless/snippets/inference/multiple/generated/typescript.md

Co-authored-by: Abdon Pijpelink <abdon.pijpelink@qdrant.com>

* Update qdrant-landing/content/documentation/hybrid-cloud/configure-scale-upgrade.md

Co-authored-by: Abdon Pijpelink <abdon.pijpelink@qdrant.com>

* Update qdrant-landing/content/documentation/cloud-api.md

Co-authored-by: Abdon Pijpelink <abdon.pijpelink@qdrant.com>

---------

Co-authored-by: Abdon Pijpelink <abdon.pijpelink@qdrant.com>
2026-03-26 17:23:36 +01:00
kanungle e2108a796f Reorg of User Manual section; refactor weights 2026-03-14 23:37:29 -07:00
kanungle 1693687c73 Reorg of User Manual section; refactor weights 2026-03-14 23:37:13 -07:00