Documentation change

Files in ./doc are both documentation and spec for this project. Some of the
findings so far are elaborated and explained.

Category: specification