improvements to common shell files

[eleanorjboyd]

For the files shellUtils and editUtils, add doc strings to the functions to help explain their functionality and return values. Additionally add a small amount of logging where necessary to improve tracing what happened and went wrong in debugging scenarios