[Doc-SIG] Reference guide, and images

Georg Brandl g.brandl at gmx.net
Wed Apr 9 20:03:06 CEST 2008


Georg Brandl schrieb:

>> 3) In the 'what's new', I have comments recording bug and patch
>> numbers, because it's useful information for me.  It strikes me
>> that this information might be interesting to include as part of
>> the published HTML.  Does that seem like a good idea?  I envision
>> something very brief; perhaps the text would read "Contributed by 
>> so-so; <patch #X>.  Can anyone suggest a better rendering?
> 
> Apart from rendering questions, this is something a custom role can do
> nicely:
> 
> Contributed by Joe; :issue:`9999`.
> 
> I'll add one to the custom Python extensions.

Okay, there is now an :issue: directive. Currently it only formats to
"issue XXX"; if you like brackets or different formatting let me know.

Georg



More information about the Doc-SIG mailing list