* docs: README re-organized * add repository structure * fix docs * docs: A few minor fixes following an earlier discussion --------- Co-authored-by: vms <michail.vms@gmail.com>