The docs seem a bit inconsistent on the use of raw lines for headings
that describe classes/methods/attributes.

The stated preference is to use a directive before the heading to make
it easier to link. Is there also a preference on whether these
headings should be raw quoted or normal text?

FWIW, my personal preference would be to remove quoting from API docs,
so for instance, remove it from the headings on this page
http://docs.djangoproject.com/en/dev/ref/forms/fields/ for the field
and class names.

But mostly I just want to know what the official stance is, if any.

Thanks.

-- 
You received this message because you are subscribed to the Google Groups 
"Django developers" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/django-developers?hl=en.

Reply via email to