use of specified as in documentation

2013-01-21 Thread Tshepang Lekhonkhobe
As an example, given this piece of doc: render(renderer_name, value, request=None, package=None) As explanation would start with: Using the renderer specified as ``renderer_name`` I think this can be misleading at first to readers, as it was to me, that renderer_name is some special type

Re: use of specified as in documentation

2013-01-21 Thread Steve Piercy
IMO, specified as implies must be and it causes me to do a double-take. Supplied as is a strange idiom and could be challenging to translate out of English. I agree with your suggestion. --steve On 1/21/13 at 10:53 PM, tshep...@gmail.com (Tshepang Lekhonkhobe) pronounced: As an