On Fri, Dec 10, 2021 at 9:57 PM Stephen J. Turnbull <
stephenjturnb...@gmail.com> wrote:

> To my mind Sphinx is sufficiently widely used


And the system used for the official Python docs.

that this settles the
> "above or below" question.


So yes :-)

However, what I haven’t seen in this thread is discussion of what I think
is the key question:

Where/how should class attribute doc strings be stored?

Tacked on to the class __doc__ ?

Another dict?

__attr_doc__

Added to __annotaions__ ?

Something else?

If they are to be available at run time, they need to go somewhere…

-CHB

>
> --
Christopher Barker, PhD (Chris)

Python Language Consulting
  - Teaching
  - Scientific Software Development
  - Desktop GUI and Web Development
  - wxPython, numpy, scipy, Cython
_______________________________________________
Python-ideas mailing list -- python-ideas@python.org
To unsubscribe send an email to python-ideas-le...@python.org
https://mail.python.org/mailman3/lists/python-ideas.python.org/
Message archived at 
https://mail.python.org/archives/list/python-ideas@python.org/message/RWTU2EJ2TIC62IU2WZZUPO3CEPLRLTRY/
Code of Conduct: http://python.org/psf/codeofconduct/

Reply via email to