doc: readme tweaks
doc: fix blocs