[Python-Dev] Documentation reorganization

Georg Brandl g.brandl at gmx.net
Wed Mar 5 08:16:59 CET 2008


Adam Olsen schrieb:

>>  I don't pretend to be speaking for anyone else, but I'd be surprised
>>  if I were unique.<wink>
> 
> Your experiences *shouldn't* be unique, but I'm afraid they might be.
> Another example is the use of BNF, which although dominant in its
> field, it provides a steep learning curve for most programmers.

We could of course accompany each BNF-described item with an example.

> I'm afraid this has turned into a rant, but it should be seen as the
> experiences of someone who relies on the documentation a great deal.
> Is there a better way to channel feedback on the documentation?

There's of course the doc-SIG, but it's just another mailing list.
In any case, the best way to channel feedback is to provide a patch <wink>

Georg



More information about the Python-Dev mailing list