updated docs and helper scripts