doc: use "it returns XXX" style instead of "XXX is returned"

Because documentation of Ruby uses "it returns XXX" style.