update docs & README with the latest changes