[Python-Dev] Documenting [C]Python's Internals

[Lie Ryan]

On 05/21/10 15:18, Yaniv Aknin wrote:
> I would if I were qualified, but I an mot. One way to get people to help
>> with details is to publish mistakes. This happens all the time on
>> python-list ;-). Pre-review would be nice though.
>>
> 
> I don't mind so much the 'humiliation' of published mistakes, but since I
> want this to be perceived as reference grade material, I prefer pre-review.
> Yesterday my first mistake was found (ugh), I published an 'Errata Policy'
> and will stick to it from now on (see the blog itself for details of the
> mistake). Thankfully, I've been approached already about pre-review, we'll
> see how this develops (this doesn't mean other people can't also offer
> themselves, six eyeballs are better than four).

How about a separate blog (or wiki) for alpha-quality articles? After an
article is written, it is first posted to the alpha blog, and after some
time and eyeballs, moved to the original blog. Of course with an open
comment system, so people can easily suggest corrections.