Path: csiph.com!v102.xanadu-bbs.net!xanadu-bbs.net!feeder.erje.net!eu.feeder.erje.net!xlned.com!feeder5.xlned.com!newsfeed.xs4all.nl!newsfeed4.news.xs4all.nl!xs4all!post.news.xs4all.nl!not-for-mail Return-Path: X-Original-To: python-list@python.org Delivered-To: python-list@mail.python.org X-Spam-Status: OK 0.003 X-Spam-Evidence: '*H*': 0.99; '*S*': 0.00; 'pycon': 0.01; 'python.': 0.02; 'anyway.': 0.05; 'beginner': 0.05; 'subject:Python': 0.06; 'important,': 0.07; 'reject': 0.07; 'suddenly': 0.07; 'craft': 0.09; 'meetup': 0.09; 'second.': 0.09; 'subject: [': 0.09; 'cc:addr:python-list': 0.11; 'python': 0.11; 'posted': 0.15; '>>': 0.16; 'docs.': 0.16; 'exist.': 0.16; 'expects': 0.16; 'guilty': 0.16; 'reasonable.': 0.16; 'stops.': 0.16; 'subject:Problems': 0.16; 'third,': 0.16; 'to:addr:pearwood.info': 0.16; 'to:addr:steve+comp.lang.python': 0.16; "to:name:steven d'aprano": 0.16; 'tutorials.': 0.16; 'language': 0.16; 'fix': 0.17; 'wrote:': 0.18; 'code.': 0.18; 'written': 0.21; '>>>': 0.22; 'programming': 0.22; 'cc:addr:python.org': 0.22; '>>>': 0.24; 'mon,': 0.24; 'question': 0.24; 'cc:2**0': 0.24; "i've": 0.25; '>': 0.26; 'first,': 0.26; 'least': 0.26; 'somewhere': 0.26; 'asking': 0.27; 'header:In-Reply-To:1': 0.27; 'chris': 0.29; 'am,': 0.29; 'important.': 0.30; 'especially': 0.30; 'message- id:@mail.gmail.com': 0.30; "i'm": 0.30; 'gives': 0.31; '-0700,': 0.31; 'context,': 0.31; "d'aprano": 0.31; 'second,': 0.31; 'steven': 0.31; 'lists': 0.32; 'probably': 0.32; 'stuff': 0.32; 'actual': 0.34; 'moment': 0.34; 'maybe': 0.34; 'subject:the': 0.34; 'could': 0.34; 'subject:with': 0.35; 'knows': 0.35; 'case,': 0.35; 'but': 0.35; 'received:google.com': 0.35; 'google': 0.35; 'there': 0.35; 'really': 0.36; 'crazy': 0.36; "he's": 0.36; 'interaction': 0.36; 'subject:skip:d 10': 0.36; 'method': 0.36; 'should': 0.36; 'too': 0.37; 'expected': 0.38; 'problems': 0.38; 'form,': 0.38; 'others.': 0.38; 'files': 0.38; 'pm,': 0.38; 'rather': 0.38; 'does': 0.39; 'mailing': 0.39; 'how': 0.40; 'read': 0.60; 'course.': 0.60; 'gone': 0.61; 'free,': 0.61; 'matter': 0.61; 'simply': 0.61; 'first': 0.61; 'back': 0.62; 'times': 0.62; 'visit': 0.64; 'places': 0.64; 'provide': 0.64; 'more': 0.64; 'great': 0.65; 'teach': 0.65; 'here': 0.66; 'answer.': 0.68; 'feeling': 0.68; 'nobody': 0.68; 'reads': 0.68; 'online': 0.71; 'websites': 0.72; 'audience': 0.74; 'attention': 0.75; 'forth': 0.81; 'fish': 0.84; 'seventh': 0.84; 'shine': 0.84; 'discovering': 0.91; 'joel': 0.91; 'subject:Don': 0.91; '2013': 0.98 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type; bh=L12My9rxEfPbONFKCIdkT9WGANX5rlBX0bUnfmkoYnA=; b=fE/bG9qWNWmUUcmD7B21G/CwvPORnH7w1oo66vx2VoWwQbQFFuqRNoAnRbAOkrSlBA 3eCD9T5cTlKLW5yvR9bvN1S2UoKCs1bG24gtzBeO4o+YkG7WrQEJbgMwU5Ps107iPPR/ VXwiPoZZG7pRG3dFjAb2RsCWYJiuzSvxfausQZUT9Bm1ULLeUFB2wRL3sCECpEoTfkKw W2JPUCMSqFKtqCMSKPpbOfgTLTrvKTyVxUAt+SYj15xTgXtQirDDJ8WoL9jvoQnyvt5v CW/tL4lkQt2b3YTvJZpQG6khg55n8KBSAmqDkN7N7jMmAklQeEo21Cr7bz0DxRUYpsOW drMA== MIME-Version: 1.0 X-Received: by 10.220.124.1 with SMTP id s1mr4325667vcr.93.1371517866899; Mon, 17 Jun 2013 18:11:06 -0700 (PDT) In-Reply-To: <51bf9299$0$29872$c3e8da3$5496439d@news.astraweb.com> References: <7wfvwkcihf.fsf@benfinney.id.au> <20130615020957.GA72426@cskk.homeip.net> <7w61xfa9y8.fsf@benfinney.id.au> <51bc8af2$0$29997$c3e8da3$5496439d@news.astraweb.com> <6dc5124d-3b00-4d53-a555-b7f31765abd7@ow4g2000pbc.googlegroups.com> <51bca9eb$0$29997$c3e8da3$5496439d@news.astraweb.com> <35734e52-2396-4ec2-938f-d5b0f592adf5@4g2000pbf.googlegroups.com> <51bcc094$0$29997$c3e8da3$5496439d@news.astraweb.com> <51be1a42$0$29966$c3e8da3$5496439d@news.astraweb.com> <96ed14e3-79dd-40c2-8063-aa58a42c7b57@googlegroups.com> <6ef1ab49-4596-4204-b0f6-10decd4f0d31@googlegroups.com> <51bf9299$0$29872$c3e8da3$5496439d@news.astraweb.com> Date: Mon, 17 Jun 2013 21:11:06 -0400 Subject: Re: Problems with Python documentation [Re: Don't feed the troll...] From: Joel Goldstick To: "Steven D'Aprano" Content-Type: multipart/alternative; boundary=089e013cbb3642813204df636385 Cc: "python-list@python.org" X-BeenThere: python-list@python.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: General discussion list for the Python programming language List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Newsgroups: comp.lang.python Message-ID: Lines: 141 NNTP-Posting-Host: 2001:888:2000:d::a6 X-Trace: 1371517876 news.xs4all.nl 15884 [2001:888:2000:d::a6]:47165 X-Complaints-To: abuse@xs4all.nl Xref: csiph.com comp.lang.python:48585 --089e013cbb3642813204df636385 Content-Type: text/plain; charset=UTF-8 On Mon, Jun 17, 2013 at 6:50 PM, Steven D'Aprano < steve+comp.lang.python@pearwood.info> wrote: > On Mon, 17 Jun 2013 07:41:54 -0700, rurpy wrote: > > > On 06/17/2013 01:23 AM, Chris Angelico wrote: > >> On Mon, Jun 17, 2013 at 3:04 PM, Ferrous Cranus > >> wrote: > >>> The only thing i'm feeling guilty is that instead of reading help > >>> files and PEP's which seem too technical for me, i prefer the live > >>> help of an actual expert human being. > >> > >> This is definitely a reason to feel guilty. You are asking people to > >> provide live help for free, rather than simply reading the > >> documentation. > > > > It is NOT a matter of simply reading the documentation. I have posted > > here several times as have many others about some of the problems the > > documentation has, especially for people who don't already know Python. > > This is very reasonable. And nobody -- well, at least not me, and > probably not Chris -- expects that reading the documentation will > suddenly cause the light to shine for every beginner who reads it. Often > the official docs are written with an expected audience who already knows > the language well. > > But in context, Nikos has been programming Python long enough, and he's > been told often enough, that his FIRST stop should be the documentation, > and us second. Not what he does now, which is to make us his first, > second, third, fourth, fifth, sixth, seventh and eighth stops. > > (Are you paying attention Nikos?) > > But speaking more generally, yes, you are right, the docs are not a > panacea. If they were, mailing lists like this, and websites like > StackOverflow, would not exist. > > > I read the python docs. I've gone through the tutorials. If not the first time, or the second, I get that Aha moment with additional reads. Some people say they learn better by other methods than reading. In that case, google like crazy because python has lots of pycon stuff online in video form, and there is the google course. and many others. If people interaction is what you need, find, and visit your local meetup or user group. Lots of places have them. If you don't have one near you, maybe you could start one so you would have local help and back and forth (fourth?). I think its great to read a question here and get a link for an answer. gives me somewhere to go explore more. If you reject these ways of learning for the single method of asking.. fix my code. Then you will never get good at this craft anyway. Its not the answers that are important, its discovering how to find the answers that is really important. The old give a man a fish, vs teach a man to fish truism -- Joel Goldstick http://joelgoldstick.com --089e013cbb3642813204df636385 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable



On Mon, Jun 17, 2013 at 6:50 PM, Steven D'Aprano <steve+comp.lang.python@pearwood.info> wrote:
On Mon, 17 Jun 2013 07:41:54 -0700, rurpy wr= ote:

> On 06/17/2013 01:23 AM, Chris Angelico wrote:
>> On Mon, Jun 17, 2013 at 3:04 PM, Ferrous Cranus <support@superhost.gr>
>> wrote:
>>> The only thing i'm feeling guilty is that instead of readi= ng help
>>> files and PEP's which seem too technical for me, i prefer = the live
>>> help of an actual expert human being.
>>
>> This is definitely a reason to feel guilty. You are asking people = to
>> provide live help for free, rather than simply reading the
>> documentation.
>
> It is NOT a matter of simply reading the documentation. I have posted<= br> > here several times as have many others about some of the problems the<= br> > documentation has, especially for people who don't already know Py= thon.

This is very reasonable. And nobody -- well, at least not me, and
probably not Chris -- expects that reading the documentation will
suddenly cause the light to shine for every beginner who reads it. Often the official docs are written with an expected audience who already knows the language well.

But in context, Nikos has been programming Python long enough, and he's=
been told often enough, that his FIRST stop should be the documentation, and us second. Not what he does now, which is to make us his first,
second, third, fourth, fifth, sixth, seventh and eighth stops.

(Are you paying attention Nikos?)

But speaking more generally, yes, you are right, the docs are not a
panacea. If they were, mailing lists like this, and websites like
StackOverflow, would not exist.



I read the python docs.= =C2=A0 I've gone through the tutorials.=C2=A0 If not the first time, or= the second, I get that Aha moment with additional reads.=C2=A0 Some people= say they learn better by other methods than reading.=C2=A0 In that case, g= oogle like crazy because python has lots of pycon stuff online in video for= m, and there is the google course.=C2=A0 and many others.=C2=A0 If people i= nteraction is what you need, find, and visit your local meetup or user grou= p.=C2=A0 Lots of places have them.=C2=A0 If you don't have one near you= , maybe you could start one so you would have local help and back and forth= (fourth?).=C2=A0 I think its great to read a question here and get a link = for an answer.=C2=A0 gives me somewhere to go explore more.=C2=A0 If you re= ject these ways of learning for the single method of asking.. fix my code.= =C2=A0 Then you will never get good at this craft anyway.=C2=A0 Its not the= answers that are important, its discovering how to find the answers that i= s really important.=C2=A0 The old give a man a fish, vs teach a man to fish= truism




--
--089e013cbb3642813204df636385--