orchestra: more docstring

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