readme: finish documentation updates