doc: minor documentation fixes
software: handle corner case when waiting for a job

Some operations may cause a restart of tog-pegasus (like its
reinstallation). Let's not put off immediately when we hit connection
error.
software: fixed handling of error cases for async ops