Project

General

Profile

Actions

Bug #15528

closed

Bundler stdlib is not documented

Added by zverok (Victor Shepelev) about 5 years ago. Updated over 4 years ago.

Status:
Closed
Target version:
-
[ruby-core:91036]

Description

Since 2.6, Bundler is a part of the standard library. But the logic of standard library docs for "default gems" (only gem's lib is copied to Ruby source tree, and libraries main class/module is rendered as a docs entry point) lead to unusable documentation for Bundler: https://docs.ruby-lang.org/en/2.6.0/Bundler.html

I am not sure how the situation should be handled, I can imagine at least 3 possible approaches:

  1. Work with Bundler team to have "basic usage" docs in lib/bundler.rb
  2. More sophisticated code copying (like copying parts of bundler's docs into lib/bundler.rb only in Ruby source tree)
  3. Rethink stdlib docs rendering to include default gems READMEs (will also require READMEs to be copied)

(1) is probably the simplest, though I am not sure Bundler team is ready to participate.

Actions

Also available in: Atom PDF

Like0
Like0Like0Like0Like0Like0