It is about tweaking inline documentation to make sure that
1. It is not ambiguous
2. It is as complete as possible.
I am surprised that I got down voted for proposing the improve a code base such that agents can run on it as a means to increased productivity.