The previous URL was not really the best IMO, but neither the new one looks like improvement.

The previous URL was not really the best IMO, but neither the new one looks like improvement.

Why do you think? I thought the new one showing more concrete level documents, while previous one just showing the concept of bson.

There are some possible URLs. Which is your best in the URLs, if you can say that?

• The previous URL: URL: http://bsonspec.org
• The new URL I updated: URL: https://docs.mongodb.com/ruby-driver/current/bson-tutorials/ , because I thought the top page was better than the version specific document at s.homepage.
• In the upstream gemspec file:

s.homepage          = 'https://docs.mongodb.com/ruby-driver/current/tutorials/bson-v4/'

  s.metadata = {
    'bug_tracker_uri' => 'https://jira.mongodb.org/projects/RUBY',
    'changelog_uri' => 'https://github.com/mongodb/bson-ruby/releases',
    'documentation_uri' => 'https://docs.mongodb.com/ruby-driver/current/tutorials/bson-v4/',
    'homepage_uri' => 'https://docs.mongodb.com/ruby-driver/current/tutorials/bson-v4/',
    'mailing_list_uri' => 'https://groups.google.com/group/mongodb-user',
    'source_code_uri' => 'https://github.com/mongodb/bson-ruby'
  }

The previous URL was not really the best IMO, but neither the new one looks like improvement.

Why do you think? I thought the new one showing more concrete level documents, while previous one just showing the concept of bson.

I always expect that if I open the URL, I will know what the package is good for, e.g. there will be basic explanation such as: "Ruby Implementation of the BSON Specification as defined at http://bsonspec.org/. You can use this packge to ....". Something what is really the "Homepage". I don't expect it to be link to the API documentation or link to tutorial.

And Frankly, the upstream is not doing good job here IMHO. The closest to what I expect is the https://github.com/mongodb/bson-ruby but it is missing the purpose of the package, i.e. why I should use it.

Thanks for sharing the expectation with the reason, Vit. It's useful to fix the different options.

The closest to what I expect is the https://github.com/mongodb/bson-ruby but it is missing the purpose of the package, i.e. why I should use it.

As your answer for my 2nd question "Which is your best in the URLs, if you can say that?", https://github.com/mongodb/bson-ruby is your best URL, right? As your actionable feedback.
I do not understand "it" in your comment "i.e. why I should use it." or the comment itself.

On rubygems.org they point to:
https://docs.mongodb.com/ruby-driver/current/tutorials/bson-v4/

and I don't think it is wrong. IMHO, if someone is looking at this package, they already know they want a BSON implementation in Ruby. First what comes to my mind is "how do I use it" (that's what is on almost every github-README page anyway).

So the tutorial would be the right place to point to, and the one-level-up page even has github page linked:
https://docs.mongodb.com/ruby-driver/current/bson-tutorials/

That works for me.

Good point, Pavel. https://docs.mongodb.com/ruby-driver/current/bson-tutorials/ has the github page link on the page. I think that the bson tutorial page can be an inclusive solution filling Vit's expectation if his expectation is the github page.

@pvalena you are looking at the issue as a Ruby developer. Try to look at it request as Fedora user. You have "rubygem-bson" installed on the system and you try to find out "why the hell is the package on my system". The first sentence from the tutorial says "This tutorial discusses using the core Ruby BSON gem." but this is useless information when you have not heard about Ruby neither about BSON yet. You don't event want to use it, you just want to figure what it is.

Rebased with previous URL http://bsonspec.org adding a comment for the URL tag.
I also did run fedpkg import too, as it seems that there will not be a big change by an additional review. Please review again.

LGTM