Groups > comp.lang.python > #81958

Re: Python docs disappointing

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	<admin@grails.asia>
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:20': 0.24; 'cc:no real name:20': 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	<h4vj45$5hl$1@reader1.panix.com> <77d357fb-342e-4856-814d-0e0003164fb1@googlegroups.com> <mailman.16030.1416502295.18130.python-list@python.org> <5480371a$0$15841$e4fe514c@dreader35.news.xs4all.nl>
Date	Fri, 5 Dec 2014 07:33:33 +0800
Subject	Re: Python docs disappointing
From	jtan <admin@grails.asia>
To	Albert van der Horst <albert@spenarnc.xs4all.nl>
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 <python-list.python.org>
List-Unsubscribe	<https://mail.python.org/mailman/options/python-list>, <mailto:python-list-request@python.org?subject=unsubscribe>
List-Archive	<http://mail.python.org/pipermail/python-list/>
List-Post	<mailto:python-list@python.org>
List-Help	<mailto:python-list-request@python.org?subject=help>
List-Subscribe	<https://mail.python.org/mailman/listinfo/python-list>, <mailto:python-list-request@python.org?subject=subscribe>
Newsgroups	comp.lang.python
Message-ID	<mailman.16595.1417736016.18130.python-list@python.org> (permalink)
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

Show key headers only | View raw

[Multipart message — attachments visible in raw view] - view raw

On Thu, Dec 4, 2014 at 6:27 PM, Albert van der Horst <
albert@spenarnc.xs4all.nl> wrote:

> In article <mailman.16030.1416502295.18130.python-list@python.org>,
> Joel Goldstick  <joel.goldstick@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  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 <http://grails.asia/> and Java <http://javadevnotes.com/>
 developer

Thread

Re: Python docs disappointing jstnms123@gmail.com - 2014-11-20 07:54 -0800
  Re: Python docs disappointing Joel Goldstick <joel.goldstick@gmail.com> - 2014-11-20 11:51 -0500
    Re: Python docs disappointing albert@spenarnc.xs4all.nl (Albert van der Horst) - 2014-12-04 10:27 +0000
      Re: Python docs disappointing Chris Angelico <rosuav@gmail.com> - 2014-12-04 21:37 +1100
      Re: Python docs disappointing Steven D'Aprano <steve+comp.lang.python@pearwood.info> - 2014-12-04 22:46 +1100
      Re: Python docs disappointing jtan <admin@grails.asia> - 2014-12-05 07:33 +0800
      Re: Python docs disappointing Michael Torrie <torriem@gmail.com> - 2014-12-04 16:57 -0700
  Re: Python docs disappointing Michael Torrie <torriem@gmail.com> - 2014-11-20 09:51 -0700
  Re: Python docs disappointing Skip Montanaro <skip.montanaro@gmail.com> - 2014-11-20 11:18 -0600
  Re: Python docs disappointing Grant Edwards <invalid@invalid.invalid> - 2014-11-20 23:10 +0000
    Re: Python docs disappointing Mark Lawrence <breamoreboy@yahoo.co.uk> - 2014-11-20 23:22 +0000
  Re: Python docs disappointing Steven D'Aprano <steve+comp.lang.python@pearwood.info> - 2014-11-21 10:29 +1100
    Re: Python docs disappointing Grant Edwards <invalid@invalid.invalid> - 2014-11-21 16:35 +0000

csiph-web