Pythondocs.info : collaborative Python documentation project

[Michael Ströder]

Re: Pythondocs.info : collaborative Python documentation project

nicolasfr@gmail .com 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 have improvements to the official docs put them into Python's SF
tracker:
http://sourceforge.net/tracker/?func...70&atid=305470

Ciao, Michael.

[Bruno Desthuilliers]

Re: Pythondocs.info : collaborative Python documentation project

nicolasfr@gmail .com wrote:

Wildemar Wildenburger wrote:

>nicolasfr@gmail .com 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

>
I don't mean to start a flame war about this but here are some
reference of people, who like me, don't like the current python doc:
http://xahlee.org/UnixResource_dir/writ/python_doc.html

Xah Lee is a well-known crank.

--
bruno desthuilliers
python -c "print '@'.join(['.'.join([w[::-1] for w in p.split('.')]) for
p in 'onurb@xiludom. gro'.split('@')])"

[Bruno Desthuilliers]

Re: Pythondocs.info : collaborative Python documentation project

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 monstruosity ahead...

--
bruno desthuilliers
python -c "print '@'.join(['.'.join([w[::-1] for w in p.split('.')]) for
p in 'onurb@xiludom. gro'.split('@')])"

[Laurent Pointal]

Re: Pythondocs.info : collaborative Python documentation project

nicolasfr@gmail .com 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 it means.

I agree in some ways, Python docs could have better organization (more links
between related things).

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

>
This is a fresh new website, so there's not much on it, but I hope to
make it grow quickly. Help and contributions are welcome; Please
register and start posting your own documentation on it.
>
Regards,
>
Nicolas.
-----
http://www.pythondocs.info

Here is another URL of such a project, i bookmarked some times:

http://www.simisen.com/jmg/cpd/

And there is nothing beyond this URL, like many of such projects.

AFAIR there is a starting of Wiki documentation - like PHP docs, one page
per function, contributors comments & Co, from one main Python developers
(dont remember who start this neither what is the URL).

In all case, dont setup another new system, use
http://wiki.python.org/moin/, at least your work will not be lost.

A+

Laurent.

[Laurent Pointal]

Re: Pythondocs.info : collaborative Python documentation project

nicolasfr@gmail .com 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 it means.
>
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

>
This is a fresh new website, so there's not much on it, but I hope to
make it grow quickly. Help and contributions are welcome; Please
register and start posting your own documentation on it.
>
Regards,
>
Nicolas.
-----
http://www.pythondocs.info

You're realy nor the first one, see

http://mail.python.org/pipermail/python-list/2004-May/219580.html

(and following thread)

Other (never achieved) projects... http://www.pythondocs.org/

Even Skip Montanaro python-glossary site seem to not have been continued...

http://mail.python.org/pipermail/python-list/2004-May/219682.html