This directory is going to be a documentation.

Not yet.

Real Programmers Don't Document Their Code. If it was
hard to write, it should be hard to understand. :-)

(wanted to get the stuff finished before pk-0.2.4, doc follows)