Path: csiph.com!v102.xanadu-bbs.net!xanadu-bbs.net!news.mixmin.net!feeds.phibee-telecom.net!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.028 X-Spam-Evidence: '*H*': 0.95; '*S*': 0.00; 'tutorial': 0.03; 'freelance': 0.05; 'that?': 0.05; 'subject:Python': 0.06; 'beginners': 0.09; 'developer': 0.10; 'cc:addr:python-list': 0.11; 'contribute': 0.11; 'language.': 0.14; 'docs.': 0.16; 'exponential': 0.16; 'numpy': 0.16; 'wrote:': 0.18; 'trying': 0.19; 'thu,': 0.19; 'community.': 0.22; 'email addr:gmail.com>': 0.22; 'cc:addr:python.org': 0.22; 'url:home': 0.24; 'java': 0.24; 'cc:2**0': 0.24; 'cc:no real name:2**0': 0.24; '>': 0.26; 'tutorials': 0.26; 'van': 0.27; 'header:In-Reply- To:1': 0.27; 'dec': 0.30; 'skip:& 60': 0.30; 'message- id:@mail.gmail.com': 0.30; 'url:mailman': 0.30; 'that.': 0.31; 'doc': 0.31; 'another': 0.32; 'url:python': 0.33; 'community': 0.33; 'ago': 0.33; 'plain': 0.33; 'received:209.85': 0.35; 'no,': 0.35; 'test': 0.35; 'received:google.com': 0.35; 'google': 0.35; 'there': 0.35; 'subject:skip:d 10': 0.36; 'url:listinfo': 0.36; 'doing': 0.36; 'url:org': 0.36; 'should': 0.36; 'wrong': 0.37; 'received:209': 0.37; 'being': 0.38; 'problems': 0.38; 'hat': 0.38; 'pm,': 0.38; 'anything': 0.39; 'visual': 0.39; 'url:mail': 0.40; 'skip:\xc2 10': 0.60; 'tell': 0.60; 'url:c': 0.67; '8bit%:31': 0.68; 'superior': 0.69; 'url:a': 0.72; 'article': 0.77; 'from:addr:admin': 0.78; 'netherlands': 0.84; 'url:asia': 0.84; 'albert': 0.91; 'critically': 0.91; 'joel': 0.91; 'economic': 0.98; 'url:m': 0.98 X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:in-reply-to:references:date :message-id:subject:from:to:cc:content-type; bh=hxbjDhYAHUmm2X7JQS37KBqqqV41Yv9nC+jSQgKdH0k=; b=Vfhuql3vBpktcnNcs00DNv4ya8D6H97j1LZnG3jzkNA8dO4BWfZbjhdSmXfXo1aR2w io4CRt3MI4JvIsnjJxzgkP+QJhtHH60klO2YZ4rtRZ0NLGZomOdj0ST1vQ0w1FonRvz1 nh26O97MkUyspcwx43hlpa8E3c3aYr8ewa6/ACEVsy3M7yEvntt48N1pkGt/SkZmnVC8 Fx+39m8dpfem4IArMN9tfZKp06NaLTt4gsglvHfRsSqwCmDObO2cSIZzos7E0mY39zGn JauzKJ73IRIqttbp0WeV74b5lyz3nCM1EoivADRoRMKTfBNfAY9/Eqz2W15BVxK2gd9z zaZQ== X-Gm-Message-State: ALoCoQlWRxs9WRi449GssHk3rG3rmSQFrfNRSXmCCl8NsimTk+zryBFveWulRMumRWRVKPwfEhsy MIME-Version: 1.0 X-Received: by 10.202.60.196 with SMTP id j187mr8087876oia.93.1417736013346; Thu, 04 Dec 2014 15:33:33 -0800 (PST) X-Originating-IP: [61.14.154.230] In-Reply-To: <5480371a$0$15841$e4fe514c@dreader35.news.xs4all.nl> References: <77d357fb-342e-4856-814d-0e0003164fb1@googlegroups.com> <5480371a$0$15841$e4fe514c@dreader35.news.xs4all.nl> Date: Fri, 5 Dec 2014 07:33:33 +0800 Subject: Re: Python docs disappointing From: jtan To: Albert van der Horst Content-Type: multipart/alternative; boundary=001a113cced87612f205096c633a 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: 111 NNTP-Posting-Host: 2001:888:2000:d::a6 X-Trace: 1417736016 news.xs4all.nl 2892 [2001:888:2000:d::a6]:56334 X-Complaints-To: abuse@xs4all.nl Xref: csiph.com comp.lang.python:81958 --001a113cced87612f205096c633a Content-Type: text/plain; charset=UTF-8 On Thu, Dec 4, 2014 at 6:27 PM, Albert van der Horst < albert@spenarnc.xs4all.nl> wrote: > In article , > Joel Goldstick wrote: > > > Plain google is far superior in finding information. > > And you tell me that writing yet another tutorial would improve that? > No, there is just one way. The powers that be should look critically > at their website, and test it with a beginners hat on. > The community is in the best place to document language. And community is not limited to the official doc site. That includes outsiders doing their share of writing tutorials and whatnot. I don't find anything wrong about that. If you have problems with the docs, why not be a part of the solution? Write a doc for numpy and contribute it to the community. Man, I remember using MSDN 15 years ago when working with Visual Studio. And it's a paid product with docs. It's horrendous. > > > > >I'm trying to wrap my mind around DOCUMENTION being STUPID. > > > >-- > >Joel Goldstick > >http://joelgoldstick.com > > Groetjes Albert > -- > Albert van der Horst, UTRECHT,THE NETHERLANDS > Economic growth -- being exponential -- ultimately falters. > albert@spe&ar&c.xs4all.nl &=n http://home.hccnet.nl/a.w.m.van.der.horst > > -- > https://mail.python.org/mailman/listinfo/python-list > -- Freelance Grails and Java developer --001a113cced87612f205096c633a Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable


On Thu, Dec 4, 2014 at 6:27 PM, Albert van der Horst = <albert@s= penarnc.xs4all.nl> wrote:
I= n article <mailman.16030.1416502295.18130.python-list@python.org>,<= br> Joel Goldstick=C2=A0 <joel.g= oldstick@gmail.com> wrote:
<SNIP>

Plain google is far superior in finding information.

And you tell me that writing yet another tutorial would improve that?
No, there is just one way. The powers that be should look critically
at their website, and test it with a beginners hat on.

The community is in the best place to document =C2=A0langua= ge.=C2=A0 And community is not limited to the official doc site.=C2=A0 That= includes outsiders doing their share of writing tutorials and whatnot.=C2= =A0 I don't find anything wrong about that.

If= you have problems with the docs, why not be a part of the solution?=C2=A0 = Write a doc for numpy and contribute it to the community.

Man, I remember using MSDN 15 years ago when working with Visual St= udio.=C2=A0 And it's a paid product with docs. It's horrendous.
=C2=A0

>
>I'm trying to wrap my mind around DOCUMENTION being STUPID.
>
>--
>Joel Goldstick
>http://joelgolds= tick.com

Groetjes Albert
--
Albert van der Horst, UTRECHT,THE NETHERLANDS
Economic growth -- being exponential -- ultimately falters.
albert@spe&ar&c.xs= 4all.nl &=3Dn http://home.hccnet.nl/a.w.m.van.der.horst

--
https://mail.python.org/mailman/listinfo/python-list



--
Freelance=C2=A0Grails and Java=C2=A0developer
--001a113cced87612f205096c633a--