This is a first step to improving the doc: - renamed directories; - augmented a fair bit of content. To be continued