Add a notice that dimension label APIs are experimental.

Author: teo-tsirpanis

sources/TileDB.CSharp/ArraySchema.cs

@@ -77,6 +77,7 @@ public void AddAttributes(params Attribute[] attrs)
         /// <param name="name">The dimension label's name.</param>
         /// <param name="labelOrder">The data order of the dimension label.</param>
         /// <param name="labelType">The dimension lable's data type.</param>
+        /// <remarks>This API is experimental and subject to breaking changes without advance notice.</remarks>
         public void AddDimensionLabel(uint dimensionIndex, string name, DataOrder labelOrder, DataType labelType)
         {
             using var ctxHandle = _ctx.Handle.Acquire();
@@ -94,6 +95,7 @@ public void AddDimensionLabel(uint dimensionIndex, string name, DataOrder labelO
         /// <param name="labelType">The dimension lable's data type.</param>
         /// <param name="extent">The dimension label's tile extent.</param>
         /// <exception cref="InvalidOperationException"><typeparamref name="T"/> and <paramref name="labelType"/> do not match.</exception>
+        /// <remarks>This API is experimental and subject to breaking changes without advance notice.</remarks>
         public void AddDimensionLabel<T>(uint dimensionIndex, string name, DataOrder labelOrder, DataType labelType, T extent) where T : struct
         {
             if (RuntimeHelpers.IsReferenceOrContainsReferences<T>() || typeof(T) != EnumUtil.DataTypeToType(labelType))
@@ -177,6 +179,7 @@ public void SetCellOrder(LayoutType layoutType)
         /// </summary>
         /// <param name="name">The dimension label's name.</param>
         /// <param name="filterList">The dimension label's filter list.</param>
+        /// <remarks>This API is experimental and subject to breaking changes without advance notice.</remarks>
         public void SetDimensionLabelFilterList(string name, FilterList filterList)
         {
             using var ctxHandle = _ctx.Handle.Acquire();
@@ -536,6 +539,7 @@ public bool HasAttribute(string name)
         /// Gets a <see cref="CSharp.DimensionLabel"/> from the <see cref="ArraySchema"/> by name.
         /// </summary>
         /// <param name="name">The dimension label's name.</param>
+        /// <remarks>This API is experimental and subject to breaking changes without advance notice.</remarks>
         public DimensionLabel DimensionLabel(string name)
         {
             var handle = new DimensionLabelHandle();
@@ -570,6 +574,7 @@ public DimensionLabel DimensionLabel(string name)
         /// Checks if a dimension label with the given name exists in the <see cref="ArraySchema"/> or not.
         /// </summary>
         /// <param name="name">The name to check.</param>
+        /// <remarks>This API is experimental and subject to breaking changes without advance notice.</remarks>
         public bool HasDimensionLabel(string name)
         {
             int has_attr;

sources/TileDB.CSharp/DataOrder.cs

@@ -5,6 +5,7 @@ namespace TileDB.CSharp
     /// <summary>
     /// Specifies the order of data in dimension labels.
     /// </summary>
+    /// <remarks>This API is experimental and subject to breaking changes without advance notice.</remarks>
     public enum DataOrder
     {
         /// <summary>

sources/TileDB.CSharp/DimensionLabel.cs

@@ -7,6 +7,7 @@ namespace TileDB.CSharp
     /// <summary>
     /// Represents a TileDB dimension label object.
     /// </summary>
+    /// <remarks>This API is experimental and susceptible to breaking changes without advance notice.</remarks>
     /// <seealso cref="ArraySchema.DimensionLabel"/>
     public sealed unsafe class DimensionLabel : IDisposable
     {

sources/TileDB.CSharp/Subarray.cs

@@ -184,6 +184,7 @@ private void ValidateType<T>(uint index) where T : struct
         /// <param name="start">The start of the dimension's range.</param>
         /// <param name="end">The end of the dimension's range.</param>
         /// <exception cref="NotSupportedException"><typeparamref name="T"/> is not supported.</exception>
+        /// <remarks>This API is experimental and subject to breaking changes without advance notice.</remarks>
         public void AddLabelRange<T>(string labelName, T start, T end) where T : struct
         {
             ValidateLabelType<T>(labelName);
@@ -204,6 +205,7 @@ private void AddLabelRange(string labelName, void* start, void* end, void* strid
         /// <param name="labelName">The dimension label's name.</param>
         /// <param name="start">The start of the dimension label's range.</param>
         /// <param name="end">The end of the dimension label's range.</param>
+        /// <remarks>This API is experimental and subject to breaking changes without advance notice.</remarks>
         public void AddLabelRange(string labelName, string start, string end)
         {
             using var ctxHandle = _ctx.Handle.Acquire();