[EMAIL PROTECTED] wrote:
> Hi,
>
> I am a bit disapointed with the current Python online documentation. I
> have read many messages of people complaining about the documentation,
> it's lack of examples and the use of complicated sentences that you
> need to read 10 times before understanding wha
[EMAIL PROTECTED] wrote:
> Hi,
>
> I am a bit disapointed with the current Python online documentation. I
> have read many messages of people complaining about the documentation,
> it's lack of examples and the use of complicated sentences that you
> need to read 10 times before understanding wha
Rakotomandimby (R12y) wrote:
> On Sat, 16 Sep 2006 22:43:41 +0200, Daniel Nogradi wrote:
>> Then how about running your site on python and not php?
>
> PHP has "better" documentation... ;-)
> More seriously, I can provide a CPS hosting to nicolasfr if he wants.
Alert ! Unusable undocumented monst
[EMAIL PROTECTED] wrote:
> Wildemar Wildenburger wrote:
>> [EMAIL PROTECTED] wrote:
>>> I have read many messages of people complaining about the documentation,
>>> it's lack of examples and the use of complicated sentences that you
>>> need to read 10 times before understanding what it means.
>>
[EMAIL PROTECTED] wrote:
>
> That's why I have started a collaborative project to make a user
> contributed Python documentation. The wiki is online here:
> http://www.pythondocs.info
Frankly I'm tired of these yet-another-wiki announcements!
Who is supposed to fill them with content?
If you hav
Brad Allen wrote:
> A.M. Kuchling wrote:
> > However, this code isn't used at the moment because I have no idea
> > what to do about version controlling the links. Do we just use the
> > current links whenever the HTML is generated? Make a copy of the list
> > and commit them into SVN, so the li
On 9/17/06, A.M. Kuchling <[EMAIL PROTECTED]> wrote:
> On Sun, 17 Sep 2006 18:10:51 +0200,
> Daniel Nogradi <[EMAIL PROTECTED]> wrote:
> > start a new one. What would be very useful though is more visible
> > links on the python.org site to the activestate repository where
> > appropriate.
A.M. Kuchling wrote:
> However, this code isn't used at the moment because I have no idea
> what to do about version controlling the links. Do we just use the
> current links whenever the HTML is generated? Make a copy of the list
> and commit them into SVN, so the links cease to be updated but
On Sun, 17 Sep 2006 18:10:51 +0200,
Daniel Nogradi <[EMAIL PROTECTED]> wrote:
> start a new one. What would be very useful though is more visible
> links on the python.org site to the activestate repository where
> appropriate. I'm not sure the pyhon.org people would want to promote
> acti
Kay Schluehr wrote:
> Personally, I never found the Python docs particular bad. It is
> rewarding to write good documentation because documentation has
> different aspects i.e. introductory/tutorial, exhaustive/manual and
> design documentation aspects. Not to mention cookbook recipes.
>
> I also
[EMAIL PROTECTED] wrote:
> Hi,
>
> I am a bit disapointed with the current Python online documentation. I
> have read many messages of people complaining about the documentation,
> it's lack of examples and the use of complicated sentences that you
> need to read 10 times before understanding what
[EMAIL PROTECTED] wrote:
> Hi,
>
> I am a bit disapointed with the current Python online documentation. I
> have read many messages of people complaining about the documentation,
> it's lack of examples and the use of complicated sentences that you
> need to read 10 times before understanding what
Somehow all of the above discussions did not mention having examples or
demos "built-in" for the language itself:
majorfunction.example()
demo("package") or package.demo()
search engine in local html documentation
apropos()
The statistical software R is bettter in this respect
> > > That said...the Python docs are open source. Just start going through
> > > them and adding examples.
> >
> > ASPN (activestate) is a good place for examples...
>
> Yes, but that requires a separate search and depends on an external
> organization. Wouldn't it be great if relevant examples we
Rakotomandimby (R12y) wrote:
> On Sat, 16 Sep 2006 12:30:56 -0700, Robert Hicks wrote:
>
> > That said...the Python docs are open source. Just start going through
> > them and adding examples.
>
> ASPN (activestate) is a good place for examples...
Yes, but that requires a separate search and depe
On Sunday 17 September 2006 04:31, Brad Allen wrote:
> Here is an idea for improving Python official documentation:
>
> Provide a tab-based interface for each entry, with the overview/summary
> at the top-level, with a row of tabs underneath:
> 1. Official documentation, with commentary pos
[EMAIL PROTECTED] wrote:
> Hi,
>
> I am a bit disapointed with the current Python online documentation. I
> have read many messages of people complaining about the documentation,
> it's lack of examples and the use of complicated sentences that you
> need to read 10 times before understanding what
Here is an idea for improving Python official documentation:
Provide a tab-based interface for each entry, with the overview/summary
at the top-level, with a row of tabs underneath:
1. Official documentation, with commentary posted at the bottom
(ala Django documentation)
2. Exampl
* [EMAIL PROTECTED] (2006-09-16 18:40 +0100)
> Wildemar Wildenburger wrote:
>> [EMAIL PROTECTED] wrote:
>>> I have read many messages of people complaining about the documentation,
>>> it's lack of examples and the use of complicated sentences that you
>>> need to read 10 times before understanding
On Sat, 16 Sep 2006 12:30:56 -0700, Robert Hicks wrote:
> That said...the Python docs are open source. Just start going through
> them and adding examples.
ASPN (activestate) is a good place for examples...
--
http://mail.python.org/mailman/listinfo/python-list
On Sat, 16 Sep 2006 22:43:41 +0200, Daniel Nogradi wrote:
> Then how about running your site on python and not php?
PHP has "better" documentation... ;-)
More seriously, I can provide a CPS hosting to nicolasfr if he wants.
--
http://mail.python.org/mailman/listinfo/python-list
[EMAIL PROTECTED] wrote:
> Hi,
>
> I am a bit disapointed with the current Python online documentation. I
> have read many messages of people complaining about the documentation,
> it's lack of examples and the use of complicated sentences that you
> need to read 10 times before understanding what
I would like to see more than one source.. Not that the documentation
is good or bad it is just that different people may come up with
different ways to explain the same thing and that is good in my view.
I would like to see the re module and the string module with as many
examples as humanly poss
[EMAIL PROTECTED] wrote:
> Rakotomandimby (R12y) wrote:
>> What you should have done first is to suggest to contribute to the
>> official Python doc.
>
> I wrote an email a few months ago to the Python docs support email
> address to offer my help but never got any answer.
>
What did that email s
> Everytime I am lookink at how to do this or that in Python I write it
> down somewhere on my computer. (For ex. Threading. After reading the
> official documentation I was a bit perplex. Hopefully I found an
> article an managed to implement threads with only like 20 lines of code
> in my script.
Rakotomandimby (R12y) wrote:
> What you should have done first is to suggest to contribute to the
> official Python doc.
I wrote an email a few months ago to the Python docs support email
address to offer my help but never got any answer.
> Then, if you encounter too much dumbs (and only in that
[EMAIL PROTECTED] wrote:
> I am a bit disapointed with the current Python online documentation. I
> have read many messages of people complaining about the documentation,
> it's lack of examples and the use of complicated sentences that you
> need to read 10 times before understanding what it means
Christoph Haas wrote:
> On Saturday 16 September 2006 19:16, [EMAIL PROTECTED] wrote:
>
> I second that the Python documentation is lacking. There is no software
> that is adequately documented anyway. Show me a man page of a Perl module
> and it takes me minutes to use it.
I would say that Perl
On Sat, 16 Sep 2006 10:40:43 -0700, nicolasfr wrote:
>>> I have read many messages of people complaining about the documentation,
>>> it's lack of examples and the use of complicated sentences that you
>>> need to read 10 times before understanding what it means.
>> Where have you read that?
> http
[EMAIL PROTECTED] wrote:
> Wildemar Wildenburger wrote:
> > [EMAIL PROTECTED] wrote:
> > > I have read many messages of people complaining about the documentation,
> > > it's lack of examples and the use of complicated sentences that you
> > > need to read 10 times before understanding what it mea
On Saturday 16 September 2006 19:16, [EMAIL PROTECTED] wrote:
> I am a bit disapointed with the current Python online documentation. I
> have read many messages of people complaining about the documentation,
> it's lack of examples and the use of complicated sentences that you
> need to read 10 tim
Wildemar Wildenburger wrote:
> [EMAIL PROTECTED] wrote:
> > I have read many messages of people complaining about the documentation,
> > it's lack of examples and the use of complicated sentences that you
> > need to read 10 times before understanding what it means.
> >
> Where have you read that
[EMAIL PROTECTED] wrote:
> Hi,
>
> I am a bit disapointed with the current Python online documentation. I
> have read many messages of people complaining about the documentation,
> it's lack of examples and the use of complicated sentences that you
> need to read 10 times before understanding what
[EMAIL PROTECTED] wrote:
> I have read many messages of people complaining about the documentation,
> it's lack of examples and the use of complicated sentences that you
> need to read 10 times before understanding what it means.
>
Where have you read that?
wildemar
--
http://mail.python.org/mai
Hi,
I am a bit disapointed with the current Python online documentation. I
have read many messages of people complaining about the documentation,
it's lack of examples and the use of complicated sentences that you
need to read 10 times before understanding what it means.
That's why I have started
35 matches
Mail list logo
