Commit Graph
33 Commits
Author SHA1 Message Date
clelia c52cfd06dd fix: go syntax checker 2026-08-12 16:52:00 +02:00
clelia ceb0e4f6de fix: attempt to enhance snippet checks by adding checks on md snippets for go, python, rust and bash 2026-08-12 16:37:43 +02:00
Andrey VasnetsovandClaude Opus 5 14fe557328 Update Edge Rust snippets to the new request interfaces (#2601)
* Update Edge Rust snippets to the new request interfaces

The edge crate replaced its mixed read interface with edge-owned request
structs and fluent builders (qdrant/qdrant#9901). Update the Rust snippets
under /documentation/edge accordingly:

- retrieve() now takes a RetrieveRequest instead of a
  (&[ids], with_payload, with_vector) triple — this was a hard break.
- Query and facet requests are built with QueryRequestBuilder /
  FacetRequestBuilder instead of struct literals, matching the published
  examples.

Also note in the quickstart that parameters left unset on an EdgeConfig
passed to load() now keep their persisted values, so the WAL-only config
no longer resets the rest of the shard configuration.

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

* Bump qdrant-edge to 0.8.0 in the rust snippet template

0.8.0 is the first release carrying the edge request structs and builders
the snippets in the previous commit use. Lockfile refreshed with
`cargo update -p qdrant-edge --precise 0.8.0`.

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

---------

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-05 17:26:52 +02:00
4f18519099 Publish docs for version 1.19 (#2550)
* [1.19] Document language-neutral BM25 text processing (#2445)

* Break Inference page into several pages

* Edits

* Document short query optimization in Cloud Inference

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

* [1.19] Document language-neutral BM25 text processing

Replaces the deprecated `language: "none"` workaround with the new explicit
API: `stemmer: {"type": "none"}` to disable stemming and `stopwords: {}`
(empty StopwordsSet) to disable stopword removal.

Updates the language-neutral snippet for all seven client languages and
refreshes the Stemming and Stopwords + Language-neutral sections in
text-search.md with a deprecation callout for the old approach.

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

* Document that stemming and stopword removal are disabled by default for payload indexes

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

* Edits

* The multilingual tokenizer doesn't do lemmatization

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

* Document `max_disk_usage_percent` for Strict Mode (#2504)

* Document max_disc_usage_percent.

* Generate MD version for the snippets.

* Rephrase sentence.

* [1.19] Documentation for the Turbo4 datatype (#2517)

* Add 'turbo4' section to Vectors docs

* Edit existing datatypes sections

* Update outdated 'Vector Datatypes' section on the Collections page

* Edit

* Documentation for the slice filtering condition (#2529)

* [1.19] Documentation for per-query IDF statistics (#2526)

* Documentation for per-query IDF statistics

* Clarify that IDF is calculated per shard

* Review feedback

* Document `X-Qdrant-Route-Affinity` header for deterministic read routing (#2541)

* Document X-Qdrant-Route-Affinity header for deterministic read routing.

* Address feedback.

* Address feedback.

* Revert "Document `max_disk_usage_percent` for Strict Mode (#2504)" (#2582)

This reverts commit 460ee971ff.

* [1.19] Documentation for resource quotas (#2586)

Document the global quota API from qdrant/qdrant#10035, which replaces the
per-collection strict mode knobs for memory and disk with a single cluster-wide
quota.

New page, ops-configuration/quotas.md (weight 7, between Configuration and
Administration):

- Configuring quotas via storage.quotas, QDRANT__STORAGE__QUOTAS__* env vars,
  and PUT /quotas, with the parameter reference
- Configuration precedence: the API wins once used anywhere in the cluster, and
  a joining peer receives the config through consensus instead of reading its
  own file
- What happens when a limit is reached: the full node's replica is excluded and
  marked dead, the write still succeeds at write_consistency_factor
  acknowledgements, and clients see HTTP 507 only when no replica can accept it
- Which operations stay allowed, the release margin, GET /quotas for finding the
  full node, and the quota_exceeded metric plus the /telemetry quota field

Supporting changes:

- configuration.md: add the storage.quotas block
- monitoring.md: add quota_exceeded to Application Metrics, and note the
  /telemetry quota field
- security.md: add get quotas and set quotas to the JWT access table
- common-errors.md: new Insufficient storage (HTTP 507) entry
- faq/qdrant-fundamentals.md: entry on writes rejected with HTTP 507
- administration.md: mark max_resident_memory_percent deprecated as of 1.19.0
- ops-configuration/_index.md: add the new page

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Test code snippets against 1.19

* Document prefix match filtering condition (#2512)

* Document prefix match filtering condition.

* Add generated files.

* Address feedback.

* Address feedback.

* [1.19] Remove links to docs for removed APIs (#2596)

* Remove links to docs for removed APIs

* Add links to new end endpoints

* Use title case for all headers

* [1.19] Add new 'Memory Tiers' page under 'Configuration' (#2510)

* Add new 'Memory Tiers' page under 'Configuration'

* Change doc structure

* Edits

* Review feedback

* [1.19] Memory tiers: existing page updates (#2535)

* Link Vector Storage section to Memory Tiers

* Update collections.md and hnsw-and-quantization snippet for Memory Tiers

* Update indexing.md for Memory Tiers, add sparse-vector-index default snippet

* Update quantization.md and its snippets for Memory
  Tiers

* Update storage.md and its snippets for Memory Tiers

* Update configuration.md for Memory Tiers

* Update administration.md Low Memory Mode section for Memory Tiers

* Update optimize.md and its snippets for Memory Tiers

* Cross-link memory-usage.md fields to Memory Tiers

* Update read-write-contention.md RAM scaling note for Memory Tiers

* Update capacity-planning.md for Memory Tiers

* Update production-checklist.md storage section for Memory Tiers

* Update what-is-qdrant.md Storage bullet for Memory Tiers

* Update cloud-getting-started.md cost-optimization tip for Memory Tiers

* Update create-cluster.md disk sizing note for Memory Tiers

* Update bulk-upload.md Upload Directly to Disk section for Memory Tiers

* Note deprecated legacy params in large-scale-search.md benchmark config

* Fix missed Update Vector Parameters section and sparse-index description for Memory Tiers

* Release blog for v1.19 (#2553)

* Initial commit

* Review feedback

* Add 'Resharding Progress' section to Web UI Enhacements

* Add preview images

* Add missing section image

* Added link to Qdrant Advisor agent skill

* Add links; small edits

* Remove max_disk_usage_percent entry

* Add Resource Quotas entry

* Update release date

* Fix create-payload-index/keyword-with-prefix/rust.rs issue

* Fix create-collection/with-memory-tiers/csharp.cs issue

* Don't publish the blog post yet

* Remove blog post from this PR

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-authored-by: István Zoltán Szabó <istvan.zoltan.szabo@qdrant.com>
2026-08-05 13:12:43 +02:00
Abdon Pijpelink d5c186c88b Document code snippet checker quirk on MacOS (#2566) 2026-07-30 16:53:42 +02:00
Jenny a88a274376 Merge pull request #2519 from qdrant/incremental-embedding-updates-tutorial
Add incremental embedding updates tutorial
2026-07-21 20:27:01 +02:00
Evgeniya Sukhodolskaya 169c167102 added snippets in all languages 2026-07-21 18:55:24 +02:00
Abdon Pijpelink 708c40573d Include imports in Edge Rust snippets (#2437)
* Allow rust code snippets to start with a comment line

* Include imports in Edge Rust snippets

* Add import per code block; use fqn when class name is ambiguous
2026-06-29 15:39:06 +02:00
dependabot[bot] 762805f8c3 Bump pillow in /automation/snippets/templates/python (#2413)
Bumps [pillow](https://github.com/python-pillow/Pillow) from 11.3.0 to 12.2.0.
- [Release notes](https://github.com/python-pillow/Pillow/releases)
- [Changelog](https://github.com/python-pillow/Pillow/blob/main/CHANGES.rst)
- [Commits](https://github.com/python-pillow/Pillow/compare/11.3.0...12.2.0)

---
updated-dependencies:
- dependency-name: pillow
  dependency-version: 12.2.0
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-06-25 14:20:37 +05:30
dependabot[bot] 39fd4f16e6 Bump pyarrow in /automation/snippets/templates/python (#2411)
Bumps [pyarrow](https://github.com/apache/arrow) from 22.0.0 to 23.0.1.
- [Release notes](https://github.com/apache/arrow/releases)
- [Commits](https://github.com/apache/arrow/compare/apache-arrow-22.0.0...apache-arrow-23.0.1)

---
updated-dependencies:
- dependency-name: pyarrow
  dependency-version: 23.0.1
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-06-25 14:20:22 +05:30
dependabot[bot] 7ea7b97efe Bump idna from 3.11 to 3.15 in /automation/snippets/templates/python (#2410)
Bumps [idna](https://github.com/kjd/idna) from 3.11 to 3.15.
- [Release notes](https://github.com/kjd/idna/releases)
- [Changelog](https://github.com/kjd/idna/blob/master/HISTORY.md)
- [Commits](https://github.com/kjd/idna/compare/v3.11...v3.15)

---
updated-dependencies:
- dependency-name: idna
  dependency-version: '3.15'
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-06-25 14:20:05 +05:30
dependabot[bot] 013443c6ae Bump urllib3 from 2.5.0 to 2.7.0 in /automation/snippets (#2424)
Bumps [urllib3](https://github.com/urllib3/urllib3) from 2.5.0 to 2.7.0.
- [Release notes](https://github.com/urllib3/urllib3/releases)
- [Changelog](https://github.com/urllib3/urllib3/blob/main/CHANGES.rst)
- [Commits](https://github.com/urllib3/urllib3/compare/2.5.0...2.7.0)

---
updated-dependencies:
- dependency-name: urllib3
  dependency-version: 2.7.0
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-06-25 14:19:15 +05:30
dependabot[bot] 633b4fbf2d Bump aiohttp in /automation/snippets/templates/python (#2433)
---
updated-dependencies:
- dependency-name: aiohttp
  dependency-version: 3.14.1
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-06-25 14:18:58 +05:30
dependabot[bot] 3e9671defe Bump urllib3 in /automation/snippets/templates/python (#2415)
Bumps [urllib3](https://github.com/urllib3/urllib3) from 2.5.0 to 2.7.0.
- [Release notes](https://github.com/urllib3/urllib3/releases)
- [Changelog](https://github.com/urllib3/urllib3/blob/main/CHANGES.rst)
- [Commits](https://github.com/urllib3/urllib3/compare/2.5.0...2.7.0)

---
updated-dependencies:
- dependency-name: urllib3
  dependency-version: 2.7.0
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-06-25 14:18:14 +05:30
Abdon PijpelinkandClaude Sonnet 4.6 ffe50340fa Edge 0.7 documentation updates (#2391)
* docs(edge): add "Modify the Vector Schema" step to quickstart

Documents the new Edge 0.7 API for adding and removing named vector
fields on an existing shard without recreating it, with Python and
Rust snippets.

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

* docs(edge): mention quantization support in quickstart

Adds a note after the EdgeConfig snippet that Edge supports all four
quantization methods (Scalar, Product, Binary, TurboQuant), with a
link to the quantization guide.

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

* docs(edge): add On-Device BM25 page for Edge 0.7

New guide covering the built-in BM25 sparse embedder: configuring a
sparse vector shard, creating a Bm25/EdgeBm25 embedder, embedding and
upserting documents, and querying. Includes Python and Rust snippets.
Also adds the page to the Edge index navigation table.

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

* docs(edge): add WAL segment size configuration to quickstart

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

* Upgrade code snippets to Edge 0.7.2

* Review feedback

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-03 15:51:20 +02:00
Abdon Pijpelink 7fd26f0e63 Test code snippets against 1.18 release 2026-05-11 16:14:29 +02:00
Abdon Pijpelink 728ea9caa7 Test python against dev branch 2026-05-11 13:04:36 +02:00
Abdon Pijpelink 435291732a Upgrade to NodeJS 22 2026-05-07 20:02:42 +02:00
Abdon Pijpelink 0ed9a24003 Pin pnpm to pnpm@9 2026-05-07 19:26:32 +02:00
Abdon Pijpelink 1b56a28a11 Pin pnpm to pnpm@8 2026-05-07 19:04:34 +02:00
Abdon Pijpelink 94a4968dac Temporarily test snippets against client 1.18 dev branches 2026-05-07 08:15:18 +02:00
Abdon Pijpelink 5591668be4 Temporary bump Go client to 1-18-x branch 2026-05-04 11:38:53 +02:00
Abdon Pijpelink 2172afc0a5 Don't hardcode 'master' as the branch 2026-05-04 10:43:31 +02:00
Derrick MwitiandAbdon Pijpelink dc564bbab0 Time based sharding tutorial (#1805)
* add snippets

* add snippets

* add snippets

* add snippets descriptions

* Initial commit

* Updated tutorial

* Expand on shard_number

* Add sentence about optimal batch size

* Show how to query multiple shards

* Small edits

* Fixes

* Add to landing page; adjust weight

* Clean up code snippets

* Don't set shard_key in code snippet

* Review feedback

* Update links to moved pages

* Add C# code snippets

* Add Go code snippets

* Add Java code snippets

* Add Rust code snippets

* Add TS code snippets

* Add note about changing collection settings

* Move CSV parsing to separate function

* Trigger Build

* Remove unused dependency

---------

Co-authored-by: Abdon Pijpelink <abdon.pijpelink@qdrant.com>
2026-04-16 22:19:08 +02:00
Abdon Pijpelinkandxzfc ea0de4c12e Edge v0.6 docs (#2199)
* Initial Rust snippets

* Update content for Rust

* Upgrade Rust to 1.94.0; test Edge code snippets against dev

* Temporarily test against Edge shim crate

* Move to EdgeShardConfig and EdgeVectorParams

* Add docs for payload indexing, filtering, facet(), and optimize()

* De-emphasize on-device use case

* Update link to Rust examples on Github

* Flattened API

* Switch to new/create and load to initialize shards

* Fixups for released packages

* Mention recover_partial_snapshot on method list

* Link to Github dev branch for examples

---------

Co-authored-by: xzfc <xzfcpw@gmail.com>
2026-03-23 15:10:51 +01:00
Abdon Pijpelink 96e837001a Test Edge code snippets (#2179)
* Add Edge and FastEmbed as Python dependencies

* Make Edge code snippets testable
2026-03-02 14:27:56 +01:00
Abdon Pijpelinkandxzfc bcc3c7206b Generate multiple code snippets from a single source file (#2146)
* Support generating multiple snippets from one source file

* Convert Python code snippets from one source file

* Add code snippets for C#, Go, Java, Rust and TS

* Make intro less Python-oriented

* Add client installation instructions for all languages

* Cleanup python code

---------

Co-authored-by: xzfc <xzfcpw@gmail.com>
2026-02-23 10:09:56 +01:00
Abdon Pijpelinkandxzfc 598f6720bf Fix problem with Go snippet compilation (#2144)
* Fix problem with Go snippet compilation

* Update automation/snippets/lib/languages/go.py

Co-authored-by: xzfc <5121426+xzfc@users.noreply.github.com>

---------

Co-authored-by: xzfc <5121426+xzfc@users.noreply.github.com>
2026-02-20 13:41:18 +01:00
378837432e Publish docs for version 1.17 (#2137)
* Cluster Telemetry docs (#2068)

* mention cluster telemetry

* small reword

* Docs for read_fan_out_delay_ms

* Add warning against setting threshold too low

* Small docs change for inference API keys

* Trigger Build

* Add guide with tips for low latency search (#2136)

* Update frontmatter weights

* Add 'Tips for Low-Latency Search' guide

* Review feedback

* Temporarily bump Rust client to v1-17-upgrade branch

* Docs for audit logging (#2141)

* Docs for audit logging

* Consistent title casing

* Review feedback

* Docs for optimization monitoring (#2121)

* Docs for optimization monitoring

* Review feedback

* Optimization monitoring is cluster-wide now

* Upgrade code snippet checker to 1.17

* Fix broken Python snippets

* Relevance Feedback docs (#2060)

* add relevance feedback in Explore page

* Review

* Trigger Build

* Trigger Build

* Create new 'Search Relevance' concept page

* Tweaks

* Update links to moved content

* add rust snippet

* TS anippets

* Clarification about using point IDs

* Add links

* Restructure paragraphs

* docs: Go snippet

Signed-off-by: Anush008 <mail@anush.sh>

* docs: Missed Java snippets with C#

Signed-off-by: Anush008 <mail@anush.sh>

* new: add python snippets

* Make Java and Rust snippets testable

* Remove unnecessary styling

---------

Signed-off-by: Anush008 <mail@anush.sh>
Co-authored-by: Evgeniya Sukhodolskaya <suxodolskaya97@gmail.com>
Co-authored-by: Abdon Pijpelink <abdon.pijpelink@qdrant.com>
Co-authored-by: Ivan Pleshkov <pleshkov.ivan@gmail.com>
Co-authored-by: Anush008 <mail@anush.sh>
Co-authored-by: George Panchuk <george.panchuk@qdrant.tech>

* Docs for enable_hnsw (#2080)

* Move 'Filterable HNSW Index' section under 'Vector Index'

* Add docs for enable_hnsw

* docs: Go snippets

Signed-off-by: Anush008 <mail@anush.sh>

* docs: Java snippets

Signed-off-by: Anush008 <mail@anush.sh>

* docs: C# snippets

Signed-off-by: Anush008 <mail@anush.sh>

* Add Rust snippet

* TS snippets

* new: add python snippets

---------

Signed-off-by: Anush008 <mail@anush.sh>
Co-authored-by: Anush008 <mail@anush.sh>
Co-authored-by: timvisee <tim@visee.me>
Co-authored-by: Ivan Pleshkov <pleshkov.ivan@gmail.com>
Co-authored-by: George Panchuk <george.panchuk@qdrant.tech>

* Docs for list shard keys API (#2082)

* Docs for list shard keys

* docs: Go snippets

Signed-off-by: Anush008 <mail@anush.sh>

* docs: Java snippets

Signed-off-by: Anush008 <mail@anush.sh>

* docs: C# snippets

Signed-off-by: Anush008 <mail@anush.sh>

* Add Rust snippet

* docs: TS snippets

* new: add python snippets

---------

Signed-off-by: Anush008 <mail@anush.sh>
Co-authored-by: Anush008 <mail@anush.sh>
Co-authored-by: timvisee <tim@visee.me>
Co-authored-by: Ivan Pleshkov <pleshkov.ivan@gmail.com>
Co-authored-by: George Panchuk <george.panchuk@qdrant.tech>

* Docs for update_mode (#2097)

* Docs for update_mode

* docs: C#, Go, Java snippets

Signed-off-by: Anush008 <mail@anush.sh>

* doc: Remove _ from C# snippet

Signed-off-by: Anush008 <mail@anush.sh>

* Add Rust snippet

* Fix some snippets

* Review feedback

* ts snippets

* new: add python snippets

* fix: add generated python.md

---------

Signed-off-by: Anush008 <mail@anush.sh>
Co-authored-by: Anush008 <mail@anush.sh>
Co-authored-by: timvisee <tim@visee.me>
Co-authored-by: Ivan Pleshkov <pleshkov.ivan@gmail.com>
Co-authored-by: George Panchuk <george.panchuk@qdrant.tech>

* Docs for weighted RRF (#2132)

* Docs for weighted RRF

* docs: Go, Java, C# snippets

Signed-off-by: Anush008 <mail@anush.sh>

* Add Rust snippet

* Apply suggestions from code review

Co-authored-by: Luis Cossío <luis.cossio@qdrant.com>

* Delete landing_page.sln

* Review feedback

* ts snippets

* new: add python snippets

* Trigger Build

---------

Signed-off-by: Anush008 <mail@anush.sh>
Co-authored-by: Anush008 <mail@anush.sh>
Co-authored-by: timvisee <tim@visee.me>
Co-authored-by: Luis Cossío <luis.cossio@qdrant.com>
Co-authored-by: Ivan Pleshkov <pleshkov.ivan@gmail.com>
Co-authored-by: George Panchuk <george.panchuk@qdrant.tech>

* Clean up Go and Java snippets

* Revert go snippet change; target Go client 1.17.1

* Updated Go snippet

* Trigger Build

* Update Rust lockfile

---------

Signed-off-by: Anush008 <mail@anush.sh>
Co-authored-by: Luis Cossío <luis.cossio@qdrant.com>
Co-authored-by: Daniel Boros <56868953+dancixx@users.noreply.github.com>
Co-authored-by: timvisee <tim@visee.me>
Co-authored-by: Evgeniya Sukhodolskaya <suxodolskaya97@gmail.com>
Co-authored-by: Ivan Pleshkov <pleshkov.ivan@gmail.com>
Co-authored-by: Anush008 <mail@anush.sh>
Co-authored-by: George Panchuk <george.panchuk@qdrant.tech>
2026-02-20 10:42:12 +01:00
xzfc 3220f5cdcf Fixed indentation in snippet checker (#2063) 2025-12-28 01:13:13 +05:30
xzfc cdfbd6538a Snipets tooling update
- update README
- generate-md.py: ignore trailing newlines when complaining about diffs
- all langs: add more dependencies to templates
- all langs: support @hide-start and @hide-end for multi-line hiding
- go: also allow one-line imports
- java: allow declarations other than `main` method
- python, typescript: implement `unshorten` for implicit imports and
  client initialization
- python: add mypy config as `datasets` lacks type py.typed
- python: hide `# mypy:` annotations
- typescript: add tsconfig that allows top-level `await`s
- typescript: depend on @types/node to fix `import ... from "crypto"`
2025-11-28 21:57:13 +00:00
xzfc 37c4abd297 Add lockfiles 2025-11-26 06:23:31 +00:00
xzfc c551dac79f Snippet tools 2025-11-26 06:23:25 +00:00