More on docstrings:

"The Frattini sublattice `\Phi(L)` is the intersection - -" vs. "Returns the Frattini subgroup of ``self``. The Frattini - -".

1) Should we include symbols in docstrings? I.e. add \otimes to ordinal_product() of posets, as used in Enumerative combinatorics?

2) What about `self` in docstrings? I have avoided it, as was suggested to me maybe a year ago. I write for example "Return True if the poset is connected - -", i.e. "the poset" instead of "``self``".

--
Jori Mäntysalo

Reply via email to