update docs & readme with latest changes