readme: more documentation updates