Re: [Python-Dev] documentation comments

2005-12-22 Thread A.M. Kuchling
On Thu, Dec 22, 2005 at 09:27:06AM +, Steve Holden wrote: > Could the PSF help here by offering annual prizes for the best > contributions to the documentation, or wouldn't that be an adequate > motivator? I think the most effective thing would be to award a grant to someone to build a real

Re: [Python-Dev] documentation comments

2005-12-22 Thread Fred L. Drake, Jr.
On Thursday 22 December 2005 09:22, A.M. Kuchling wrote: > I had lunch with Fred the other day, and he was worried about whether > anyone would garden the comments to remove spam. That is indeed an > issue, but I think we can cope with that problem once a system is > built. > > Another worry

Re: [Python-Dev] documentation comments

2005-12-22 Thread Neal Norwitz
On 12/22/05, A.M. Kuchling <[EMAIL PROTECTED]> wrote: > > I had lunch with Fred the other day, and he was worried about whether > anyone would garden the comments to remove spam. I would help assuming this is easy--meaning a single click to remove a comment. n

Re: [Python-Dev] documentation comments

2005-12-22 Thread Fred L. Drake, Jr.
On Thursday 22 December 2005 13:44, Neal Norwitz wrote: > I would help assuming this is easy--meaning a single click to remove a > comment. It looks like the system the MySQL folks are using makes it easy, but I've not tried polluting their documentation with tests, just in case. :-) In gener

Re: [Python-Dev] documentation comments

2005-12-24 Thread Facundo Batista
2005/12/22, Fred L. Drake, Jr. <[EMAIL PROTECTED]>: > In general, my worry is less with dealing with spam than with ensuring > integration of content enhancements before release candidates go out. Well, I think that the most important part of annotable documentation is just cuantitative feedback,