Readability and documentation adjustments

Prompted by comments in https://github.com/google/hesokuri/pull/13