docs basis and readme improvements