shell automator docs

overdue documentation for shell automator