On Thu, Nov 25, 2010 at 2:25 PM, Adam V. <[email protected]> wrote: > 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. > >
Personally I'd prefer that we only have the :real-markup:, however as it doesn't generate actual TOC entries it makes them near useless. If someone, <wink />, were to figure out how to have those it would be awesome ;) Alex -- "I disapprove of what you say, but I will defend to the death your right to say it." -- Voltaire "The people's good is the highest law." -- Cicero "Code can always be simpler than you think, but never as simple as you want" -- Me -- 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.
