FAQ-D: doc build, sphinx warnings

[josef-pkt]

(notes on doc build, sphinx warnings, put here to make it easier to find)

section title in properties of classes

example reference section in a cached property
.../statsmodels/miscmodels/ordinal_model.py:docstring of statsmodels.miscmodels.ordinal_model.OrderedResults:81: CRITICAL: Unexpected section title.

can be ignored, we have many of those
sections in docstrings of properties are removed in the class docstring, but rendered correctly in docstring of property

duplicate label, names differ only in capitalization

example: links have many duplicates with capitalized and lower case names, e.g.
/statsmodels/docs/source/generated/statsmodels.genmod.families.links.cloglog.rst:2: WARNING: duplicate label generated/statsmodels.genmod.families.links.cloglog:statsmodels.genmod.families.links.cloglog, other instance in /home/runner/work/statsmodels/statsmodels/docs/source/generated/statsmodels.genmod.families.links.CLogLog.rst

can be ignored in docbuild,
but try to avoid public, documented names of objects that only differ in capitalization

[bashtage]

The property bug is annoying.