Update Bulk Upload tutorial for best practices (#2407)

* Make Bulk Upload tutorial code snippets testable

* Align Bulk Upload tutorial with agent skill

* Update Bulk Upload tutorial

* Update title

* Remove 'Disable Indexing' section

qdrant-landing/content/documentation/headless/snippets/create-collection/with-two-shards/_description.md

@@ -0,0 +1 @@
+This code snippet is used to create a collection with two shards. Increasing the shard number allows you to distribute the collection data across multiple nodes in a cluster.

qdrant-landing/content/documentation/headless/snippets/create-collection/with-two-shards/csharp.cs

@@ -0,0 +1,18 @@
+using Qdrant.Client;
+using Qdrant.Client.Grpc;
+
+public class Snippet
+{
+	public static async Task Run()
+	{
+		// @hide-start
+		var client = new QdrantClient("localhost", 6334);
+		// @hide-end
+
+		await client.CreateCollectionAsync(
+			collectionName: "{collection_name}",
+			vectorsConfig: new VectorParams { Size = 768, Distance = Distance.Cosine },
+			shardNumber: 2
+		);
+	}
+}

qdrant-landing/content/documentation/headless/snippets/create-collection/with-two-shards/generated/csharp.md

@@ -0,0 +1,10 @@
+```csharp
+using Qdrant.Client;
+using Qdrant.Client.Grpc;
+
+await client.CreateCollectionAsync(
+	collectionName: "{collection_name}",
+	vectorsConfig: new VectorParams { Size = 768, Distance = Distance.Cosine },
+	shardNumber: 2
+);
+```

qdrant-landing/content/documentation/headless/snippets/create-collection/with-two-shards/generated/go.md

@@ -0,0 +1,16 @@
+```go
+import (
+	"context"
+
+	"github.com/qdrant/go-client/qdrant"
+)
+
+client.CreateCollection(context.Background(), &qdrant.CreateCollection{
+	CollectionName: "{collection_name}",
+	VectorsConfig: qdrant.NewVectorsConfig(&qdrant.VectorParams{
+		Size:     768,
+		Distance: qdrant.Distance_Cosine,
+	}),
+	ShardNumber: qdrant.PtrOf(uint32(2)),
+})
+```

qdrant-landing/content/documentation/headless/snippets/create-collection/with-two-shards/generated/java.md

@@ -0,0 +1,24 @@
+```java
+import io.qdrant.client.QdrantClient;
+import io.qdrant.client.QdrantGrpcClient;
+import io.qdrant.client.grpc.Collections.CreateCollection;
+import io.qdrant.client.grpc.Collections.Distance;
+import io.qdrant.client.grpc.Collections.VectorParams;
+import io.qdrant.client.grpc.Collections.VectorsConfig;
+
+client
+    .createCollectionAsync(
+        CreateCollection.newBuilder()
+            .setCollectionName("{collection_name}")
+            .setVectorsConfig(
+                VectorsConfig.newBuilder()
+                    .setParams(
+                        VectorParams.newBuilder()
+                            .setSize(768)
+                            .setDistance(Distance.Cosine)
+                            .build())
+                    .build())
+            .setShardNumber(2)
+            .build())
+    .get();
+```

qdrant-landing/content/documentation/headless/snippets/create-collection/with-two-shards/generated/python.md

@@ -0,0 +1,9 @@
+```python
+from qdrant_client import QdrantClient, models
+
+client.create_collection(
+    collection_name="{collection_name}",
+    vectors_config=models.VectorParams(size=768, distance=models.Distance.COSINE),
+    shard_number=2,
+)
+```

qdrant-landing/content/documentation/headless/snippets/create-collection/with-two-shards/generated/rust.md

@@ -0,0 +1,12 @@
+```rust
+use qdrant_client::qdrant::{CreateCollectionBuilder, Distance, VectorParamsBuilder};
+use qdrant_client::Qdrant;
+
+client
+    .create_collection(
+        CreateCollectionBuilder::new("{collection_name}")
+            .vectors_config(VectorParamsBuilder::new(768, Distance::Cosine))
+            .shard_number(2),
+    )
+    .await?;
+```

qdrant-landing/content/documentation/headless/snippets/create-collection/with-two-shards/generated/typescript.md

@@ -0,0 +1,11 @@
+```typescript
+import { QdrantClient } from "@qdrant/js-client-rest";
+
+client.createCollection("{collection_name}", {
+  vectors: {
+    size: 768,
+    distance: "Cosine",
+  },
+  shard_number: 2,
+});
+```

qdrant-landing/content/documentation/headless/snippets/create-collection/with-two-shards/go.go

@@ -0,0 +1,27 @@
+package snippet
+
+import (
+	"context"
+
+	"github.com/qdrant/go-client/qdrant"
+)
+
+func Main() {
+	// @hide-start
+	client, err := qdrant.NewClient(&qdrant.Config{
+		Host: "localhost",
+		Port: 6334,
+	})
+
+	if err != nil { panic(err) }
+	// @hide-end
+
+	client.CreateCollection(context.Background(), &qdrant.CreateCollection{
+		CollectionName: "{collection_name}",
+		VectorsConfig: qdrant.NewVectorsConfig(&qdrant.VectorParams{
+			Size:     768,
+			Distance: qdrant.Distance_Cosine,
+		}),
+		ShardNumber: qdrant.PtrOf(uint32(2)),
+	})
+}

qdrant-landing/content/documentation/headless/snippets/create-collection/with-two-shards/http.md

@@ -0,0 +1,10 @@
+```http
+PUT /collections/{collection_name}
+{
+    "vectors": {
+      "size": 768,
+      "distance": "Cosine"
+    },
+    "shard_number": 2
+}
+```

qdrant-landing/content/documentation/headless/snippets/create-collection/with-two-shards/java.java

@@ -0,0 +1,33 @@
+package com.example.snippets_amalgamation;
+
+import io.qdrant.client.QdrantClient;
+import io.qdrant.client.QdrantGrpcClient;
+import io.qdrant.client.grpc.Collections.CreateCollection;
+import io.qdrant.client.grpc.Collections.Distance;
+import io.qdrant.client.grpc.Collections.VectorParams;
+import io.qdrant.client.grpc.Collections.VectorsConfig;
+
+public class Snippet {
+        public static void run() throws Exception {
+                // @hide-start
+                QdrantClient client =
+                    new QdrantClient(QdrantGrpcClient.newBuilder("localhost", 6334, false).build());
+                // @hide-end
+
+                client
+                    .createCollectionAsync(
+                        CreateCollection.newBuilder()
+                            .setCollectionName("{collection_name}")
+                            .setVectorsConfig(
+                                VectorsConfig.newBuilder()
+                                    .setParams(
+                                        VectorParams.newBuilder()
+                                            .setSize(768)
+                                            .setDistance(Distance.Cosine)
+                                            .build())
+                                    .build())
+                            .setShardNumber(2)
+                            .build())
+                    .get();
+        }
+}

qdrant-landing/content/documentation/headless/snippets/create-collection/with-two-shards/python.py

@@ -0,0 +1,11 @@
+from qdrant_client import QdrantClient, models
+
+# @hide-start
+client = QdrantClient(url="http://localhost:6333")
+# @hide-end
+
+client.create_collection(
+    collection_name="{collection_name}",
+    vectors_config=models.VectorParams(size=768, distance=models.Distance.COSINE),
+    shard_number=2,
+)

qdrant-landing/content/documentation/headless/snippets/create-collection/with-two-shards/rust.rs

@@ -0,0 +1,18 @@
+use qdrant_client::qdrant::{CreateCollectionBuilder, Distance, VectorParamsBuilder};
+use qdrant_client::Qdrant;
+
+pub async fn main() -> anyhow::Result<()> {
+    // @hide-start
+    let client = Qdrant::from_url("http://localhost:6334").build()?;
+    // @hide-end
+
+    client
+        .create_collection(
+            CreateCollectionBuilder::new("{collection_name}")
+                .vectors_config(VectorParamsBuilder::new(768, Distance::Cosine))
+                .shard_number(2),
+        )
+        .await?;
+
+    Ok(())
+}

qdrant-landing/content/documentation/headless/snippets/create-collection/with-two-shards/typescript.ts

@@ -0,0 +1,13 @@
+import { QdrantClient } from "@qdrant/js-client-rest";
+
+// @hide-start
+const client = new QdrantClient({ host: "localhost", port: 6333 });
+// @hide-end
+
+client.createCollection("{collection_name}", {
+  vectors: {
+    size: 768,
+    distance: "Cosine",
+  },
+  shard_number: 2,
+});

qdrant-landing/content/documentation/headless/snippets/update-collection/simple/csharp.cs

@@ -5,7 +5,7 @@ public class Snippet
 {
 	public static async Task Run()
 	{
-		var client = new QdrantClient("localhost", 6334);
+		var client = new QdrantClient("localhost", 6334); // @hide
 
 		await client.UpdateCollectionAsync(
 			collectionName: "{collection_name}",

qdrant-landing/content/documentation/headless/snippets/update-collection/simple/generated/csharp.md

@@ -2,8 +2,6 @@
 using Qdrant.Client;
 using Qdrant.Client.Grpc;
 
-var client = new QdrantClient("localhost", 6334);
-
 await client.UpdateCollectionAsync(
 	collectionName: "{collection_name}",
 	optimizersConfig: new OptimizersConfigDiff { IndexingThreshold = 10000 }

qdrant-landing/content/documentation/headless/snippets/update-collection/simple/generated/go.md

@@ -5,11 +5,6 @@ import (
 	"github.com/qdrant/go-client/qdrant"
 )
 
-client, err := qdrant.NewClient(&qdrant.Config{
-	Host: "localhost",
-	Port: 6334,
-})
-
 client.UpdateCollection(context.Background(), &qdrant.UpdateCollection{
 	CollectionName: "{collection_name}",
 	OptimizersConfig: &qdrant.OptimizersConfigDiff{

qdrant-landing/content/documentation/headless/snippets/update-collection/simple/go.go

@@ -7,12 +7,14 @@ import (
 )
 
 func Main() {
+	// @hide-start
 	client, err := qdrant.NewClient(&qdrant.Config{
 		Host: "localhost",
 		Port: 6334,
 	})
 
-	if err != nil { panic(err) } // @hide
+	if err != nil { panic(err) } 
+	// @hide-end
 
 	client.UpdateCollection(context.Background(), &qdrant.UpdateCollection{
 		CollectionName: "{collection_name}",