address some documentation feedback
finish up the <return> results, singular <summary>