what-is-a-gem section is misleading

Dmitry's Avatar

Dmitry

13 Oct, 2016 10:26 PM

The http://guides.rubygems.org/what-is-a-gem/ section starts with the structure of a gem instead of explaining what it is, and why you should care.

The section talks about (1) what the structure of a gem is, and (2) the spec of a gem.

What it doesn't do is answer the question "what is a gem".

After reading the page, I still had no idea what a gem was.

  1. Support Staff 1 Posted by indirect on 13 Oct, 2016 10:33 PM

    indirect's Avatar

    The documentation is answering the question literally and correctly: a set of files with this structure and a spec like this are a gem. If you'd like it to explain more than that, you're welcome to add to the documentation in a pull request!

  2. indirect closed this discussion on 13 Oct, 2016 10:33 PM.

Comments are currently closed for this discussion. You can start a new one.

Keyboard shortcuts

Generic

? Show this help
ESC Blurs the current field

Comment Form

r Focus the comment reply box
^ + ↩ Submit the comment

You can use Command ⌘ instead of Control ^ on Mac