Add small description for main classes

Author: FrancescAlted

src/blosc2/c2array.py

@@ -182,6 +182,8 @@ def slice_to_string(slice_):
 
 
 class C2Array(blosc2.Operand):
+    """Remote compressed NDArray accessed from a Caterva2 server."""
+
     def __init__(self, path: str, /, urlbase: str | None = None, auth_token: str | None = None):
         """Create an instance of a remote NDArray.
 

src/blosc2/ctable.py

@@ -510,6 +510,8 @@ def as_dict(self) -> dict[str, Any]:
 
 
 class Column:
+    """Column view for a :class:`CTable`, with vectorized operations and reductions."""
+
     _REPR_PREVIEW_ITEMS = 8
 
     def __init__(self, table: CTable, col_name: str, mask=None):
@@ -1432,6 +1434,8 @@ def _fmt_bytes(n: int) -> str:
 
 
 class CTable(Generic[RowT]):
+    """Columnar compressed table with typed columns and row-oriented access."""
+
     #: Ordered list of stored column names.  Computed columns are **not**
     #: included; access those via :attr:`computed_columns`.
     col_names: list[str]

src/blosc2/dict_store.py

@@ -27,7 +27,7 @@
 
 class DictStore:
     """
-    Directory-based storage for compressed data using Blosc2.
+    Dictionary-like storage for compressed Blosc2 objects.
 
     Manages arrays in a directory or zip-file backed format.
 

src/blosc2/lazyexpr.py

@@ -368,6 +368,8 @@ def __str__(self):
 
 
 class LazyArray(ABC, blosc2.Operand):
+    """Base class for lazy array expressions that compute data on demand."""
+
     def _get_user_vlmeta(self) -> dict[str, Any]:
         if not hasattr(self, "_vlmeta_user"):
             self._vlmeta_user = {}

src/blosc2/ndarray.py

@@ -3746,6 +3746,8 @@ def __next__(self):
 
 
 class NDArray(blosc2_ext.NDArray, Operand):
+    """Compressed, chunked N-dimensional array with NumPy-like indexing."""
+
     def __init__(self, **kwargs):
         self._schunk = SChunk(_schunk=kwargs["_schunk"], _is_view=True)  # SChunk Python instance
         self._keep_last_read = False
@@ -6813,6 +6815,8 @@ def iter_sorted(
 # Class for dealing with fields in an NDArray
 # This will allow to access fields by name in the dtype of the NDArray
 class NDField(Operand):
+    """View of one field from an :class:`NDArray` with a structured dtype."""
+
     def __init__(self, ndarr: NDArray, field: str):
         """
         Create a new NDField.

src/blosc2/schunk.py

@@ -191,6 +191,8 @@ def __str__(self):
 
 
 class SChunk(blosc2_ext.SChunk):
+    """Compressed super-chunk storing a sequence of compressed chunks."""
+
     def __init__(  # noqa: C901
         self,
         chunksize: int | None = None,