ruby / ruby/rubygems

Suggestion: make --no-document the default

Open
#1,965 14 comments 5 reactions 1 assignee View on GitHub

@hsbt is already working on this.

Since Oct 28, 2025.

status: blocked / backlog type: feature request type: major bump
Dominant language
Ruby
Stars
4k
Forks
1.9k
Avg merge
1d 2h
Merged PRs (30d)
81

Description

I just wanted to propose this in case it hadn't been proposed before.

In my 10 or 11 years of using Ruby, I've never seen someone use rdoc or ri locally on their machine. I'm sure there are some people out there using it but I would bet a large majority never do. If I'm correct (and maybe I'm not) isn't the speedier install times and avoiding generation of unused files a more sensible default and couldn't we reverse things to make it so you have to put --document in your .gemrc when you need that?

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.