readme documentation and corrections