[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