doc and readme fixes