updated automated script documentation

Fixes #958.