improvements to common shell files

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