Issue #21350 has been updated by Eregon (Benoit Daloze). I agree each bundled gem hosting its own docs is the best. In some cases it might be valuable to host multiple versions of the docs, although that quickly adds complexity. In fact the same applies for normal gems as well. For example concurrent-ruby hosts its docs at https://ruby-concurrency.github.io/concurrent-ruby/ And FFI should host its docs itself too, especially since the issues with rubydoc.info mentioned in https://github.com/ffi/ffi/pull/1142.
So if we standardize the RDoc generation configs for other bundled gems, we can definitely make a shared GH actions to publish their docs in the same way.
That could be quite convenient, especially if it can be used for normal gems outside the ruby org as well. https://github.com/ruby/irb/blob/master/.github/workflows/gh-pages.yml is already quite short though so maybe it's good enough as-is. ---------------------------------------- Misc #21350: Bundled gems lack online documentation https://bugs.ruby-lang.org/issues/21350#change-113345 * Author: osyoyu (Daisuke Aritomo) * Status: Open ---------------------------------------- Libraries which have been converted into bundled gems seem to have no online documentation. For example, `csv` had its documentation inside docs.ruby-lang.org up to Ruby 3.3: https://docs.ruby-lang.org/en/3.3/CSV.html but after it has turned into a bundled gem, there is no online documentation (try searching in https://docs.ruby-lang.org/en/3.4/). This is the case for all bundled gems, including major modules such as `Base64` (missing since 3.4 docs) and `Logger` (missing since master docs). Given that these libraries are still `require`able without any special installation, it would be nice to have their documentation on docs.ruby-lang.org (or somewhere online reachable from Google). -- https://bugs.ruby-lang.org/