reorganisation and rewriting of internals documentation