[pypy-dev] documentation progress!

[holger krekel]

Hello PyPy,

apart from the new "architecture" document the Amsterdam Sprint also
produced a "goals" document which i now think should be rewritten to 
be (much) more higher level. See here for reference

    http://codespeak.net/pypy/index.cgi?doc/goals

As it stands it's IMHO very confusing to understand from this document
what PyPy aims at. I guess the current 'goals' document is more like
an extensive "todo list" and maybe should just be renamed.  (Because from 
a Todo-document one a) doesn't expect to understand everything at once 
and b) expects more lower level details).  

Apart from this little renaming we also concluded earlier that we want to 
have a "Status" document which should offer precise information about the
implementation/concept status regarding our "components": 
interpreter, standard/flow/trace/trivial object spaces, annotation and
translation. Each of these components should then have a list of main
pieces wrong, missing, incomplete or (yes they exist!) complete. 

Btw, Armin has in the last days added/modified a chapter about Multimethods 
and Annotations (type inference):

    http://codespeak.net/pypy/index.cgi?doc/objspace/multimethod

    http://codespeak.net/pypy/index.cgi?doc/translation/annotation

but don't forget to read the architecture document first in case you
e.g.  stumble on the term "object space" and don't know what it means :-) 

    http://codespeak.net/pypy/index.cgi?doc/architecture

cheers and some happy last days of the year,

    holger