diff --git a/docs/source/api/distributions/discrete.rst b/docs/source/api/distributions/discrete.rst
index dd9971b174..79e66bab8b 100644
--- a/docs/source/api/distributions/discrete.rst
+++ b/docs/source/api/distributions/discrete.rst
@@ -19,3 +19,8 @@ Discrete
    OrderedLogistic
    OrderedProbit
    Poisson
+
+.. note::
+
+   **OrderedLogistic and OrderedProbit:**
+   The `OrderedLogistic` and `OrderedProbit` distributions expect the observed values to be 0-based, i.e., they should range from `0` to `K-1`. Using 1-based indexing (like `1, 2, 3,...K`) can result in errors.