- made HDL block diagram clearer
- updated architecture organization figure
- updated folder structure
- changed overall document organization, `Folder structure' and
`Getting around the code sections' are now after `Introduction'
- some small changes in text and wording

Signed-off-by: Thedi Stana <t.stana@cern.ch>