orchestra: fine tune docstrings.

Signed-off-by: John Spray <john.spray@redhat.com>