Update ruby_gem doc with newlines so code lines up with descriptions

Also remove broken link to results object, replaced it with just the type to expect since a link to a github file seems likely to break in the future