Comment that outlines parametrisation behaviour

Author: honno

array_api_tests/test_elementwise_functions.py

@@ -29,7 +29,17 @@
 # We might as well use this implementation rather than xp.broadcast_shapes()
 from .test_broadcasting import broadcast_shapes
 
+
+# When appropiate, this module tests operators alongside their respective
+# elementwise methods. We do this by parametrizing a generalised test method
+# with every relevant method and operator. Notably each parameter includes a
+# function object, which for operator test cases is a wrapper that allows test
+# logic to be generalised.
+
+
 func_to_op = {v: k for k, v in dh.op_to_func.items()}
+all_op_to_symbol = {**dh.binary_op_to_symbol, **dh.inplace_op_to_symbol}
+finite_kw = {"allow_nan": False, "allow_infinity": False}
 
 unary_argnames = ("func_name", "func", "strat")
 UnaryParam = Param[str, Callable[[Array], Array], st.SearchStrategy[Array]]
@@ -48,9 +58,6 @@ def make_unary_params(
     ]
 
 
-all_op_to_symbol = {**dh.binary_op_to_symbol, **dh.inplace_op_to_symbol}
-finite_kw = {"allow_nan": False, "allow_infinity": False}
-
 binary_argnames = (
     "func_name",
     "func",