Re: [cctbxbb] Sphinx docs for CCTBX

Hi guys, my 2p about that if you don't mind. I think that ideally, we should try to find a way to pass the doxygen documentation into Sphinx. If it is too much work to figure out, then of your 3 variants, (3) would be my preferred choice because it puts the documentation as close to the code that is actually documented, i.e. the wrapped C++ code. If the code has already been structured as your (1), this is most likely because the Python function does more than the C++ function, and the documentation should be in the overriden Python function then. Your variant (2) is just too ugly to my taste. Best wishes, Luc