update doco; goal() is obsolete

Reviewed at https://rbcommons.com/s/twitter/r/931/