My concern is that in YARD `@return [URI, Hash]` means that method returns either `URI` or `Hash`:
http://rubydoc.info/gems/yard/file/docs/Tags.md#return

Probably change to:

``` ruby
# @return [Array<URI, Hash>]
```