[ruby-core:101849] [Ruby master Misc#17499] Documentation backporting

Issue #17499 has been reported by zverok (Victor Shepelev).

----------------------------------------
Misc #17499: Documentation backporting
https://bugs.ruby-lang.org/issues/17499

* Author: zverok (Victor Shepelev)
* Status: Open
* Priority: Normal
----------------------------------------
I recently noticed that the documentation created after `x.y` release (even 1 day after) never reflected at `docs.ruby-lang.org/<x.y>.0/`.

In discussion [here](https://github.com/ruby/docs.ruby-lang.org/issues/111) I was educated by @hsbt that the source of `docs.ruby-lang.org/<x.y>.0/` is actually a branch `ruby_<x_y>`, so in order to appear at docs.ruby-lang.org, documentation should be "backported" into the proper branch, which usually does not happen.

A few examples (documentation submitted by me, but it is not that I consider "my" documentation the most important, it is just easier for me to track):
* `doc/syntax/pattern_matching.rdoc`: [merged](https://github.com/ruby/ruby/pull/2786) on 2020-02-23, but is not represented here: https://docs.ruby-lang.org/en/2.7.0/ -- because it isn't present in [ruby_2_7](https://github.com/ruby/ruby/tree/ruby_2_7/doc/syntax) branch.
* update `doc/syntax/methods.rdoc` (add endless methods and `...`-forwarding): [merged](https://github.com/ruby/ruby/pull/3997) 2020-12-25 (just a few hours after 3.0 release), but not represented here: https://docs.ruby-lang.org/en/3.0.0/doc/syntax/methods_rdoc.html -- because it isn't in [ruby_3_0](https://github.com/ruby/ruby/blob/ruby_3_0/doc/syntax/methods.rdoc) branch.

**IMPORTANT**: It is just two random examples, I believe there are numerous problems like that.

I wonder how this should be addressed:
* should somebody gather all the occurrences to "commits that should be picked into the proper branches"?
* can it be done in some systematic manner?
* can at least currently developed (3.0's) enhancements be "backported" in some automatic manner (PR labels?..)



-- 
https://bugs.ruby-lang.org/

Unsubscribe: <mailto:[e-mail]?subject=unsubscribe>
<http://lists.ruby-lang.org/cgi-bin/mailman/options/ruby-core>