address suggestions from github review

Author: reint-fischer

docs/_autoapi_templates/python/class.rst

@@ -1,3 +1,4 @@
+{# Adapted from sphinx-autoapi https://github.com/readthedocs/sphinx-autoapi #}
 {% if obj.display %}
     {% if is_own_page %}
 {{ obj.id }}

docs/_autoapi_templates/python/module.rst

@@ -1,3 +1,4 @@
+{# Adapted from sphinx-autoapi https://github.com/readthedocs/sphinx-autoapi #}
 {% if obj.display %}
    {% if is_own_page %}
 {{ obj.id }}

src/parcels/__init__.py

@@ -9,18 +9,18 @@
 
 import warnings as _stdlib_warnings
 
-from parcels._core.basegrid import BaseGrid
-from parcels._core.field import Field, VectorField
 from parcels._core.fieldset import FieldSet
+from parcels._core.particleset import ParticleSet
 from parcels._core.kernel import Kernel
+from parcels._core.particlefile import ParticleFile
 from parcels._core.particle import (
-    KernelParticle,  # ? remove?
+    Variable,
     Particle,
     ParticleClass,
-    Variable,
+    KernelParticle,  # ? remove?
 )
-from parcels._core.particlefile import ParticleFile
-from parcels._core.particleset import ParticleSet
+from parcels._core.field import Field, VectorField
+from parcels._core.basegrid import BaseGrid
 from parcels._core.uxgrid import UxGrid
 from parcels._core.xgrid import XGrid
 
@@ -52,16 +52,16 @@
 
 __all__ = [  # noqa: RUF022
     # Core classes
-    "BaseGrid",
-    "Field",
-    "VectorField",
     "FieldSet",
+    "ParticleSet",
     "Kernel",
+    "ParticleFile",
+    "Variable",
     "Particle",
     "ParticleClass",
-    "Variable",
-    "ParticleFile",
-    "ParticleSet",
+    "Field",
+    "VectorField",
+    "BaseGrid",
     "UxGrid",
     "XGrid",
     # Converters

src/parcels/_core/basegrid.py

@@ -22,7 +22,7 @@ class GridType(IntEnum):
 
 
 class BaseGrid(ABC):
-    """Docstring for Basegrid class"""
+    """Define a base class for parcels X and Ux grids with common methods and properties"""
 
     @abstractmethod
     def search(self, z: float, y: float, x: float, ei=None) -> dict[str, tuple[int, float | np.ndarray]]: