[pypy-dev] Refining terminology

[holger krekel]

Hi Bengt, 

On Tue, Jul 12, 2005 at 11:00 -0700, Bengt Richter wrote:
> At 12:19 2005-07-12 +0200, you (holger krekel) wrote:
> >Any opinions or feedback (also from people just following
> >the project's progress)?
> I think any project tends to accumulate informal docs re key concepts
> and implementation details, but they tend to be hard to find until
> someone collects good links and the good-link collection becomes
> available and advertised via some standard place to look for docs,
> like a doc wiki or project docs home page.
> 
> Then somone like you realizes that the link collection represents a kind
> of archive of conceptual evolution, and doesn't have consistent terminology
> and doesn't even all represent the exactly the same (never mind "official")
> view of the concepts (naturally, since they were evolving).

Actually at least some core developers are discussing core terminologies 
for quite some time now, especially when we have to synchronize and 
give a talk together (we often do group-talks, i.e. not only one
person speaking the whole time). 

> So how to identify/create a representation of a project for a prospective
> explorer? A map, some pictures, a guide pamphlet that tells how to hike
> (read: walk the code and docs) to the best views? These are useful even
> for veteran explorers who pride themselves on being able to slog through
> most any jungle, especially if their appetite for slogging is waning ;-)

:-) 

> Best wishes. I hope to do some hiking one of these days ;-)
> Where is the best trailhead now to enter the pypy territory/jungle/parklands?
> (I hope there will always be some wild life, even when part of the territory
> gets leased for industrial parks ;-)

Actually i would be interested in experiences from your hiking expedition
which you might start here: 

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

and in particular the very first "architecture" link.  Note that 
the main entry page has a cross-referenced directory index. 

cheers, 

    holger