what-is-a-gem section is misleading

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.

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

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!
- Edit
indirect closed this discussion on 13 Oct, 2016 10:33 PM.

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

New Issue
Conversation Started
The discussion is closed

No more actions from RubyGems.org or the discussion starter are required.
Re-open the discussion Re-open the discussion

This discussion is private. Only you and RubyGems.org support staff can see and reply to it.

This discussion is public. Everyone can see and reply to it.

Keyboard shortcuts

?	Show this help
ESC	Blurs the current field

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

You can use Command ⌘ instead of Control ^ on Mac

	30 Jun, 2020 03:12 PM	Unable to download data from https://rubygems.org/ - Received fatal alert: protocol_version (https://rubygems.org/specs.4.8.gz)
	30 Jun, 2020 02:40 PM	Why is my changelog_uri wrong?
	30 Jun, 2020 02:24 PM	Problem when ruby install_gems.rb
	30 Jun, 2020 01:54 PM	Transfer gem ownership
	06 Jun, 2020 04:51 PM	Unable to update or install gems

	Supporter FAQ
	FAQ
	Removing an accidentally pushed gem
	Removing a published RubyGem
	Common Problems