improved docs, improved scripts