doc: rename ci files. make the doc ci trigger on tag or manual push.

Made dependency management better. clarified param x for hist api.

Author: ElouenGinat

.github/workflows/ci.yml .github/workflows/ci.yaml.github/workflows/ci.yml renamed to .github/workflows/ci.yaml

@@ -47,7 +47,7 @@ jobs:
       - name: Install doc build requirements
         run: |
           uv venv .build-env
-          uv pip install --python .build-env -r docs/requirements.txt
+          uv sync
       - name: Build Sphinx Documentation
         run: |
           . .build-env/bin/activate
@@ -58,9 +58,11 @@ jobs:
         with:
           name: khisto-python-docs
           path: ./docs/_build/html/
-  # Publish to GH pages on Git tag and manually
+  # Publish to GH pages on Git tag push or manual dispatch
   publish:
-    if: github.ref_type == 'tag' && github.event_name == 'workflow_dispatch' && inputs.deploy-gh-pages == true
+    if: >-
+      (github.ref_type == 'tag' && github.event_name == 'push') ||
+      (github.event_name == 'workflow_dispatch' && inputs.deploy-gh-pages == true)
     needs: build
     runs-on: ubuntu-22.04
     permissions:

.github/workflows/docs.yaml

@@ -197,7 +197,7 @@ Key Differences
      - ``bins``, ``stacked``, and ``weights`` raise a ``TypeError``
    * - **Multiple datasets**
      - Supported
-     - Sequences are concatenated into one dataset
+     - Sequences are concatenated into one dataset. Sequences of different lengths are not supported.
 
 Usage Comparison
 """"""""""""""""

.github/workflows/pack-pip.yml .github/workflows/pack-pip.yaml.github/workflows/pack-pip.yml renamed to .github/workflows/pack-pip.yaml

@@ -16,16 +16,16 @@ matplotlib = ["matplotlib>=3.8"]
 all = ["matplotlib>=3.8"]
 
 [dependency-groups]
-dev = [
+test = [
     "pytest>=8.3",
     "pytest-xdist>=3.6",
     "pytest-cov>=6",
     "pytest-sugar>=1.0",
+]
+lint = [
     "pre-commit>=4.1",
     "pre-commit-hooks>=5.0",
     "ruff>=0.9",
-    "ipykernel>=7",
-    "matplotlib>=3.8",
 ]
 docs = [
     "sphinx>=6.1",
@@ -37,6 +37,11 @@ docs = [
     "ipykernel>=7",
     "matplotlib>=3.8",
 ]
+dev = [
+    {include-group = "test"},
+    {include-group = "lint"},
+    {include-group = "docs"},
+]
 
 [build-system]
 requires = ["scikit-build-core>=0.11.6", "ninja"]

docs/api_comparison.rst

@@ -74,7 +74,8 @@ def hist(
     ----------
     x : array_like or sequence of array_like
         Input data. Nested arrays are concatenated and histogrammed as a
-        single dataset.
+        single dataset. This behavior is different from Matplotlib's hist, which treats a sequence of
+        arrays as multiple datasets and plots them separately.
     range : tuple of (float, float), optional
         Lower and upper range of the bins. Values outside the range are
         ignored.