improved scripts, and docs