docs + better scripts