Log in

MosheZadkasProblemsWithStructuredText

Hmm - since Moshe is in charge of the Python
PEP 216 (Docstring Format) I assume that this is the reference to use. Specific issues
are his perception that StructuredText doesn't cope with

A tag that means "this is a Python ", guess what

Tags that mean "this is a Python class/module/etc".

which are needed to allow for cross-referencing into the module being
documented (or, indeed, other issues).

There are other unresolved issues as well - see the PEP.

Copyright (c) 2011 Zope Foundation. All rights reserved.
Legal | Contact
If you can read this text, it means you are not experiencing the Plone design at its best.
Plone makes heavy use of CSS, which means it is accessible to any internet browser,
but the design needs a
standards-compliant browser to look like we intended it.
Just so you know ;)