[pypy-dev] explicit documentation (re)organization

Anna Martelli Ravenscroft anna at aleax.it
Sun Nov 7 10:16:59 CET 2004


Laura Creighton wrote:
> In a message of Sat, 06 Nov 2004 12:34:31 +0100, holger krekel writes:

<much snippage>

> What you don't know is that that particular document was the one and only
> time I had ever managed to make ReST do <something>.  Or I thought up a
> neat way to express something, or I had to look up the spelling of a word.
> All in all, this means that the document continues to have present and lasting 
> value to me beyond its value to you -- or anybody else.

In other words, your document has meta-value over and above whatever it 
happens to be documenting. This is a good point.

> But I don't notice that it is gone until the next time I need something
> from it, and then I expect to be able to find it by clicking on something.
> So what I would prefer is a quasi-mirror of the pypy site, with a header
> of 'obsolete'.  If it isn't in the current, then I can find old docs in the
> same location as they would be if they were still current.  I need to be
> able to do 'click-click-click -- aha, there is the table I was looking for --'
> and then get on with what I want.

Laura and Holger -
is there a way I can help with this? I miss working with you guys, and 
this seems like somewhere that I could be useful, whether or not I fully 
comprehend the ins and outs of where the pypy project is at the moment.

Please let me know - offlist if you like.

Anna





More information about the Pypy-dev mailing list