[Doc-SIG] Shouldn't tutorial follow the pep8?

INADA Naoki songofacandy at gmail.com
Mon Mar 7 06:45:40 CET 2011


I've make a patch and post it to http://bugs.python.org/issue11425

On Mon, Mar 7, 2011 at 7:56 AM, Michael Foord <fuzzyman at voidspace.org.uk> wrote:
> On 06/03/2011 22:28, INADA Naoki wrote:
>>
>> In http://docs.python.org/py3k/tutorial/classes.html#random-remarks
>>
>>> Possible conventions include capitalizing method names, prefixing
>>> data attribute names with a small unique string (perhaps just an
>>> underscore),
>>> or using verbs for methods and nouns for data attributes.
>>
>> Capitalizing methd names doesn't follows pep8.
>>
>> Many sample codes in tutorial doesn't follow pep8 too.
>> For example, in
>> http://docs.python.org/py3k/tutorial/introduction.html#numbers
>> there are no spaces next to operators.
>
> I believe a patch to the tutorial bringing it inline with pep 8 would be
> accepted (and a good thing).
>
> All the best,
>
> Michael
>
> --
> http://www.voidspace.org.uk/
>
> May you do good and not evil
> May you find forgiveness for yourself and forgive others
> May you share freely, never taking more than you give.
> -- the sqlite blessing http://www.sqlite.org/different.html
>
>



-- 
INADA Naoki  <songofacandy at gmail.com>


More information about the Doc-SIG mailing list