📝 Documenation fix related to bdl_input_iterator (#691)

* 📝 Reordered enumeration to match the `enum class` value order

* 📝 Added missing Python classes to the `bdl_input_iterator` RST documentation

* 📝 Update pyfiction docstrings

Signed-off-by: GitHub Actions <[email protected]>

---------

Signed-off-by: GitHub Actions <[email protected]>
Co-authored-by: GitHub Actions <[email protected]>

Author: marcelwa

bindings/mnt/pyfiction/include/pyfiction/pybind11_mkdoc_docstrings.hpp

@@ -787,12 +787,13 @@ R"doc(This enum defines how BDL inputs are manipulated within the algorithm.
 According to existing literature, there are two main approaches for
 handling BDL inputs:
 
-1. A perturber is used to set the input to `1`, while the absence of a
-perturber represents a `0` (as described in
-https://ieeexplore.ieee.org/abstract/document/8963859). 2. An input of
-`1` is generated by placing a perturber closer to the target, whereas
-a `0` is produced by positioning the perturber farther away (as
-described in https://dl.acm.org/doi/10.1145/3489517.3530525).)doc";
+1. Distance Encoding, in which an input of `1` is generated by placing
+a perturber closer to the target, whereas a `0` is produced by
+positioning the perturber farther away (as described in
+https://dl.acm.org/doi/10.1145/3489517.3530525). 2. Absence Encoding,
+in which a perturber is used to set the input to `1`, while the
+absence of a perturber represents a `0` (as described in
+https://ieeexplore.ieee.org/abstract/document/8963859).)doc";
 
 static const char *__doc_fiction_bdl_input_iterator_params_input_bdl_configuration_PERTURBER_ABSENCE_ENCODED =
 R"doc(A perturber is used to set the input to `1`, while the absence of a

docs/algorithms/iterators.rst

@@ -29,6 +29,10 @@ BDL Input Iterator
            :members:
 
     .. tab:: Python
+        .. autoclass:: mnt.pyfiction.input_bdl_configuration
+            :members:
+        .. autoclass:: mnt.pyfiction.bdl_input_iterator_params
+            :members:
         .. autoclass:: mnt.pyfiction.bdl_input_iterator_100
             :members:
         .. autoclass:: mnt.pyfiction.bdl_input_iterator_111

include/fiction/algorithms/iter/bdl_input_iterator.hpp

@@ -27,10 +27,11 @@ struct bdl_input_iterator_params
      * This enum defines how BDL inputs are manipulated within the algorithm.
      * According to existing literature, there are two main approaches for handling BDL inputs:
      *
-     * 1. A perturber is used to set the input to `1`, while the absence of a perturber represents a `0`
-     *    (as described in https://ieeexplore.ieee.org/abstract/document/8963859).
-     * 2. An input of `1` is generated by placing a perturber closer to the target, whereas a `0` is produced
-     *    by positioning the perturber farther away (as described in https://dl.acm.org/doi/10.1145/3489517.3530525).
+     * 1. Distance Encoding, in which an input of `1` is generated by placing a perturber closer to the target, whereas
+     * a `0` is produced by positioning the perturber farther away (as described in
+     * https://dl.acm.org/doi/10.1145/3489517.3530525).
+     * 2. Absence Encoding, in which a perturber is used to set the input to `1`, while the absence of a perturber
+     * represents a `0` (as described in https://ieeexplore.ieee.org/abstract/document/8963859).
      */
     enum class input_bdl_configuration : uint8_t
     {