Krzysztof Findeisen: short answer is that we need the include-all-objects flag to make this happen, as in:

.. automodapi:: lsst.afw.display

   :no-main-docstr:

   :no-inheritance-diagram:

   :include-all-objects:

automodapi doensn't have a way of making this a default, so I'll have to either upstream a change to automodapi, or update the templates to include this.

I also can't get my own docstrigs to be used — I'm always getting an autogenerated Pybind11 docstring for these constants.

Thanks for looking into this. I'm a bit baffled by the idea of lsst.afw.display.BLACK having a Pybind11 docstring, since it's defined in Python.

I don't think that's pybind11's fault; I think that's the docstring for str itself. See e.g. https://stackoverflow.com/questions/41236007/create-object-type-from-a-string.

Ah my local build failed so my path must not be using the new afw.

I can confirm that https://pipelines.lsst.io/v/weekly/modules/lsst.afw.display/index.html does not include "BLACK.

I've moved this out of the backlog to check when we refresh the Pipelines documentation infrastructure and then more actively debug the afw.display documentation at that point.