Enhance Weaviate Client Models with Detailed Documentation and New Features

- Added comprehensive XML documentation comments to the Move class, ObjectMetadata, Property, and various result models to improve clarity and usability.
- Introduced new properties in ObjectMetadata for better metadata handling, including CreationTime, LastUpdateTime, Distance, Certainty, Score, ExplainScore, IsConsistent, and RerankScore.
- Expanded the Property class with additional tokenization strategies and factory methods for various data types, enhancing property creation flexibility.
- Implemented new GroupByResult and WeaviateGroup classes to support grouping in query results, along with generative AI capabilities in results.
- Enhanced the WeaviateObject model with detailed properties for better data representation, including UUID, Collection, Metadata, Tenant, Properties, References, and Vectors.
- Introduced HybridNearVector and HybridNearText records for hybrid search configurations, allowing for combined vector and text-based queries.
- Updated ShardingConfig with detailed sharding strategies and functions, improving data distribution management.
- Enhanced VectorConfig and VectorIndex classes with detailed documentation and new configurations for vector indexing and multi-vector search behavior.

Author: mpartipilo

src/Weaviate.Client/Models/Collection.cs

@@ -1,31 +1,78 @@
 namespace Weaviate.Client.Models;
 
+/// <summary>
+/// Base class for collection configuration, containing common settings shared between creation and update operations.
+/// </summary>
+/// <remarks>
+/// A collection in Weaviate is similar to a table in traditional databases or a collection in MongoDB.
+/// It defines the schema (properties and references), indexing behavior, and various configurations
+/// for storing and searching data objects.
+/// </remarks>
 public abstract record CollectionConfigCommon
 {
+    /// <summary>
+    /// Gets or sets the name of the collection. Must be unique within the Weaviate instance.
+    /// </summary>
     public string Name { get; set; } = "";
+
+    /// <summary>
+    /// Gets or sets the description of the collection, explaining its purpose and contents.
+    /// </summary>
     public string Description { get; set; } = "";
 
-    // Define properties of the collection.
+    /// <summary>
+    /// Gets or sets the properties (data fields) defined for this collection.
+    /// Properties define the schema for data objects stored in the collection.
+    /// </summary>
     public Property[] Properties { get; set; } = [];
+
+    /// <summary>
+    /// Gets or sets the cross-references to other collections.
+    /// References enable relationships between objects in different collections.
+    /// </summary>
     public Reference[] References { get; set; } = [];
 
-    // inverted index config
+    /// <summary>
+    /// Gets or sets the inverted index configuration for filtering and keyword search.
+    /// The inverted index is used for BM25 keyword search and filtering operations.
+    /// </summary>
     public InvertedIndexConfig? InvertedIndexConfig { get; set; }
 
+    /// <summary>
+    /// Gets or sets the reranker configuration for improving search result quality.
+    /// Rerankers can reorder search results using more sophisticated models.
+    /// </summary>
     public IRerankerConfig? RerankerConfig { get; set; }
 
+    /// <summary>
+    /// Gets or sets the generative AI configuration for RAG (Retrieval-Augmented Generation).
+    /// Enables integration with LLMs for generating text based on search results.
+    /// </summary>
     public IGenerativeConfig? GenerativeConfig { get; set; }
 
-    // multi tenancy config
+    /// <summary>
+    /// Gets or sets the multi-tenancy configuration.
+    /// Multi-tenancy enables data isolation for different tenants within the same collection.
+    /// </summary>
     public MultiTenancyConfig? MultiTenancyConfig { get; set; }
 
-    // replication config
+    /// <summary>
+    /// Gets or sets the replication configuration for data redundancy and high availability.
+    /// Controls how many copies of data are maintained across the cluster.
+    /// </summary>
     public ReplicationConfig? ReplicationConfig { get; set; }
 
-    // Manage how the index should be sharded and distributed in the cluster
+    /// <summary>
+    /// Gets or sets the sharding configuration, controlling how data is distributed across cluster nodes.
+    /// Sharding enables horizontal scaling of data storage and query performance.
+    /// </summary>
     public ShardingConfig? ShardingConfig { get; set; }
 
-    // Configure named vectors. Either use this field or `vectorizer`, `vectorIndexType`, and `vectorIndexConfig` fields. Available from `v1.24.0`.
+    /// <summary>
+    /// Gets or sets the named vector configurations for this collection.
+    /// Supports multiple vector spaces per collection (available from Weaviate v1.24.0).
+    /// Use this for multi-vector setups, or use the legacy single-vector configuration.
+    /// </summary>
     public VectorConfigList VectorConfig { get; set; } = default!;
 
     public override int GetHashCode()

src/Weaviate.Client/Models/InvertedIndexConfig.cs

@@ -1,18 +1,57 @@
 namespace Weaviate.Client.Models;
 
+/// <summary>
+/// Configuration for the inverted index used for filtering and keyword search.
+/// </summary>
+/// <remarks>
+/// The inverted index is used for filtering operations and BM25 keyword search.
+/// This configuration controls various aspects of index behavior including cleanup intervals,
+/// BM25 scoring, stopword handling, and timestamp indexing.
+/// </remarks>
 public record InvertedIndexConfig : IEquatable<InvertedIndexConfig>
 {
     private static readonly Lazy<InvertedIndexConfig> defaultInstance =
         new Lazy<InvertedIndexConfig>(() => new());
 
+    /// <summary>
+    /// Gets the default inverted index configuration with standard settings.
+    /// </summary>
     public static InvertedIndexConfig Default => defaultInstance.Value;
 
+    /// <summary>
+    /// Gets or sets the BM25 configuration for keyword search scoring. Defaults to <see cref="BM25Config.Default"/>.
+    /// </summary>
     public BM25Config? Bm25 { get; set; } = BM25Config.Default;
+
+    /// <summary>
+    /// Gets or sets the interval in seconds between index cleanup operations. Defaults to 60 seconds.
+    /// </summary>
     public int CleanupIntervalSeconds { get; set; } = 60;
+
+    /// <summary>
+    /// Gets or sets a value indicating whether to index null values for filtering. Defaults to false.
+    /// </summary>
     public bool IndexNullState { get; set; } = false;
+
+    /// <summary>
+    /// Gets or sets a value indicating whether to index property lengths for filtering. Defaults to false.
+    /// </summary>
     public bool IndexPropertyLength { get; set; } = false;
+
+    /// <summary>
+    /// Gets or sets a value indicating whether to index object timestamps (creation and update times). Defaults to false.
+    /// </summary>
     public bool IndexTimestamps { get; set; } = false;
+
+    /// <summary>
+    /// Gets or sets the stopword configuration for text processing. Defaults to <see cref="StopwordConfig.Default"/>.
+    /// </summary>
     public StopwordConfig? Stopwords { get; set; } = StopwordConfig.Default;
+
+    /// <summary>
+    /// Gets or sets a value indicating whether to use BlockMax WAND algorithm for faster BM25 queries.
+    /// When null, Weaviate uses its default setting.
+    /// </summary>
     public bool? UsingBlockMaxWAND { get; set; } = null;
 
     public override int GetHashCode()