Author xmorel
Recipients bethard, docs@python, ezio.melotti, ncoghlan, xmorel
Date 2012-01-24.20:20:56
SpamBayes Score 2.56048e-07
Marked as misclassified No
Message-id <1327436456.97.0.540077296119.issue13850@psf.upfronthosting.co.za>
In-reply-to
Content
> The "Parameters" column would span multiple lines, with one parameter and a brief description of the parameter on each line.

I started looking into that, and it turns out that's more annoying than expected: a bunch of parameters are shared by many (to all) actions, leading to lots of duplications in the table. And the full matrix of actions to parameters is not really explained in the doc.

In fact, I'm coming around to thinking a matrix of the interaction between actions and arguments could be better and clearer than a table of actions with parameters bunched together at the end.

In any case, it would certainly be more maintainable... except for rST not really having support for attributes on data tables, and (as far as I can tell) can't handle horizontal headers.
History
Date User Action Args
2012-01-24 20:20:57xmorelsetrecipients: + xmorel, ncoghlan, bethard, ezio.melotti, docs@python
2012-01-24 20:20:56xmorelsetmessageid: <1327436456.97.0.540077296119.issue13850@psf.upfronthosting.co.za>
2012-01-24 20:20:56xmorellinkissue13850 messages
2012-01-24 20:20:56xmorelcreate