turkdevops · pull · Nov 28, 2025 · Nov 27, 2025 · Nov 27, 2025 · Nov 20, 2025
diff --git a/array.c b/array.c
@@ -3521,7 +3521,7 @@ static VALUE rb_ary_bsearch_index(VALUE ary);
  *  Returns the element from +self+ found by a binary search,
  *  or +nil+ if the search found no suitable element.
  *
- *  See {Binary Searching}[rdoc-ref:bsearch.rdoc].
+ *  See {Binary Searching}[rdoc-ref:language/bsearch.rdoc].
  *
  *  Related: see {Methods for Fetching}[rdoc-ref:Array@Methods+for+Fetching].
  */
@@ -3545,7 +3545,7 @@ rb_ary_bsearch(VALUE ary)
  *  Returns the integer index of the element from +self+ found by a binary search,
  *  or +nil+ if the search found no suitable element.
  *
- *  See {Binary Searching}[rdoc-ref:bsearch.rdoc].
+ *  See {Binary Searching}[rdoc-ref:language/bsearch.rdoc].
  *
  *  Related: see {Methods for Fetching}[rdoc-ref:Array@Methods+for+Fetching].
  */

diff --git a/box.c b/box.c
@@ -796,7 +796,7 @@ rb_initialize_main_box(void)
     if (!box_experimental_warned) {
         rb_category_warn(RB_WARN_CATEGORY_EXPERIMENTAL,
                          "Ruby::Box is experimental, and the behavior may change in the future!\n"
-                         "See doc/box.md for known issues, etc.");
+                         "See doc/language/box.md for known issues, etc.");
         box_experimental_warned = 1;
     }
 
@@ -1048,7 +1048,7 @@ rb_f_dump_classext(VALUE recv, VALUE klass)
  *  Document-class: Ruby::Box
  *
  *  :markup: markdown
- *  :include: doc/_box.md
+ *  :include: doc/language/box.md
  */
 void
 Init_Box(void)

diff --git a/common.mk b/common.mk
@@ -1822,11 +1822,11 @@ $(UNICODE_HDR_DIR)/name2ctype.h:
 		$(UNICODE_SRC_DATA_DIR) $(UNICODE_SRC_EMOJI_DATA_DIR) > $@.new
 	$(MV) $@.new $@
 
-srcs-doc: $(srcdir)/doc/regexp/unicode_properties.rdoc
-$(srcdir)/doc/regexp/$(ALWAYS_UPDATE_UNICODE:yes=unicode_properties.rdoc): \
+srcs-doc: $(srcdir)/doc/language/regexp/unicode_properties.rdoc
+$(srcdir)/doc/language/regexp/$(ALWAYS_UPDATE_UNICODE:yes=unicode_properties.rdoc): \
 	$(UNICODE_HDR_DIR)/name2ctype.h $(UNICODE_PROPERTY_FILES)
 
-$(srcdir)/doc/regexp/unicode_properties.rdoc:
+$(srcdir)/doc/language/regexp/unicode_properties.rdoc:
 	$(Q) $(BOOTSTRAPRUBY) $(tooldir)/generic_erb.rb -c -o $@ \
 		$(srcdir)/template/unicode_properties.rdoc.tmpl \
 		$(UNICODE_SRC_DATA_DIR) $(UNICODE_HDR_DIR)/name2ctype.h || \

diff --git a/doc/.document b/doc/.document
@@ -2,11 +2,12 @@
 [^_]*.rb
 [^_]*.rdoc
 contributing
+distribution
 NEWS
 syntax
 optparse
 date
 rdoc
-regexp
-yjit
-ruby
+jit
+security
+language
diff --git a/doc/_regexp.rdoc b/doc/_regexp.rdoc
@@ -39,7 +39,7 @@ A regexp may be used:
   most such methods accept an argument that may be either a string
   or the (much more powerful) regexp.
 
-  See {Regexp Methods}[rdoc-ref:regexp/methods.rdoc].
+  See {Regexp Methods}[rdoc-ref:language/regexp/methods.rdoc].
 
 == \Regexp Objects
 
@@ -821,7 +821,7 @@ Or by using <tt>\P</tt> (uppercase +P+):
   /\P{Alpha}/.match('1') # => #<MatchData "1">
   /\P{Alpha}/.match('a') # => nil
 
-See {Unicode Properties}[rdoc-ref:regexp/unicode_properties.rdoc]
+See {Unicode Properties}[rdoc-ref:language/regexp/unicode_properties.rdoc]
 for regexps based on the numerous properties.
 
 Some commonly-used properties correspond to POSIX bracket expressions:

diff --git a/doc/bug_triaging.rdoc → doc/contributing/bug_triaging.rdoc b/doc/bug_triaging.rdoc → doc/contributing/bug_triaging.rdoc
diff --git a/doc/contributing/building_ruby.md b/doc/contributing/building_ruby.md
@@ -184,7 +184,7 @@ cause build failures.
 ## Building on Windows
 
 The documentation for building on Windows can be found in [the separated
-file](../windows.md).
+file](../distribution/windows.md).
 
 ## More details
 

diff --git a/doc/dtrace_probes.rdoc → doc/contributing/dtrace_probes.rdoc b/doc/dtrace_probes.rdoc → doc/contributing/dtrace_probes.rdoc
diff --git a/doc/memory_view.md → doc/contributing/memory_view.md b/doc/memory_view.md → doc/contributing/memory_view.md
diff --git a/doc/distribution.md → doc/distribution/distribution.md b/doc/distribution.md → doc/distribution/distribution.md
diff --git a/doc/windows.md → doc/distribution/windows.md b/doc/windows.md → doc/distribution/windows.md
diff --git a/doc/yjit/yjit.md → doc/jit/yjit.md b/doc/yjit/yjit.md → doc/jit/yjit.md
diff --git a/doc/zjit.md → doc/jit/zjit.md b/doc/zjit.md → doc/jit/zjit.md
diff --git a/doc/_box.md → doc/language/box.md b/doc/_box.md → doc/language/box.md
diff --git a/doc/bsearch.rdoc → doc/language/bsearch.rdoc b/doc/bsearch.rdoc → doc/language/bsearch.rdoc
diff --git a/doc/date/calendars.rdoc → doc/language/calendars.rdoc b/doc/date/calendars.rdoc → doc/language/calendars.rdoc
diff --git a/doc/case_mapping.rdoc → doc/language/case_mapping.rdoc b/doc/case_mapping.rdoc → doc/language/case_mapping.rdoc
diff --git a/doc/character_selectors.rdoc → doc/language/character_selectors.rdoc b/doc/character_selectors.rdoc → doc/language/character_selectors.rdoc
diff --git a/doc/dig_methods.rdoc → doc/language/dig_methods.rdoc b/doc/dig_methods.rdoc → doc/language/dig_methods.rdoc
diff --git a/doc/encodings.rdoc → doc/language/encodings.rdoc b/doc/encodings.rdoc → doc/language/encodings.rdoc
diff --git a/doc/exceptions.md → doc/language/exceptions.md b/doc/exceptions.md → doc/language/exceptions.md
diff --git a/doc/fiber.md → doc/language/fiber.md b/doc/fiber.md → doc/language/fiber.md
diff --git a/doc/format_specifications.rdoc → doc/language/format_specifications.rdoc b/doc/format_specifications.rdoc → doc/language/format_specifications.rdoc
diff --git a/doc/globals.md → doc/language/globals.md b/doc/globals.md → doc/language/globals.md
diff --git a/doc/hash_inclusion.rdoc → doc/language/hash_inclusion.rdoc b/doc/hash_inclusion.rdoc → doc/language/hash_inclusion.rdoc
diff --git a/doc/implicit_conversion.rdoc → doc/language/implicit_conversion.rdoc b/doc/implicit_conversion.rdoc → doc/language/implicit_conversion.rdoc
diff --git a/doc/marshal.rdoc → doc/language/marshal.rdoc b/doc/marshal.rdoc → doc/language/marshal.rdoc
diff --git a/doc/ruby/option_dump.md → doc/language/option_dump.md b/doc/ruby/option_dump.md → doc/language/option_dump.md
diff --git a/doc/ruby/options.md → doc/language/options.md b/doc/ruby/options.md → doc/language/options.md
@@ -682,7 +682,7 @@ CESU-8
 ### `--jit`
 
 Option `--jit` is an alias for option `--yjit`, which enables YJIT;
-see additional YJIT options in the [YJIT documentation](rdoc-ref:yjit/yjit.md).
+see additional YJIT options in the [YJIT documentation](rdoc-ref:jit/yjit.md).
 
 ### `--verbose`: Set `$VERBOSE`
 

diff --git a/doc/packed_data.rdoc → doc/language/packed_data.rdoc b/doc/packed_data.rdoc → doc/language/packed_data.rdoc
@@ -159,7 +159,7 @@ Any directive may be followed by either of these modifiers:
     'AB'.unpack('C3')   # => [65, 66, nil]
 
   Note: Directives in <tt>%w[A a Z m]</tt> use +count+ differently;
-  see {String Directives}[rdoc-ref:@String+Directives].
+  see {String Directives}[rdoc-ref:language/packed_data.rdoc@String+Directives].
 
 If elements don't fit the provided directive, only least significant bits are encoded:
 

diff --git a/doc/ractor.md → doc/language/ractor.md b/doc/ractor.md → doc/language/ractor.md
diff --git a/doc/regexp/methods.rdoc → doc/language/regexp/methods.rdoc b/doc/regexp/methods.rdoc → doc/language/regexp/methods.rdoc
diff --git a/doc/regexp/unicode_properties.rdoc → doc/language/regexp/unicode_properties.rdoc b/doc/regexp/unicode_properties.rdoc → doc/language/regexp/unicode_properties.rdoc
diff --git a/doc/signals.rdoc → doc/language/signals.rdoc b/doc/signals.rdoc → doc/language/signals.rdoc
diff --git a/doc/strftime_formatting.rdoc → doc/language/strftime_formatting.rdoc b/doc/strftime_formatting.rdoc → doc/language/strftime_formatting.rdoc
@@ -522,5 +522,4 @@ An ISO 8601 combined date and time representation may be any
 ISO 8601 date and any ISO 8601 time,
 separated by the letter +T+.
 
-For the relevant +strftime+ formats, see {Dates}[rdoc-ref:@Dates] and
-{Times}[rdoc-ref:@Times] above.
+For the relevant +strftime+ formats, see {Dates}[rdoc-ref:@Dates] and {Times}[rdoc-ref:@Times] above.
diff --git a/doc/command_injection.rdoc → doc/security/command_injection.rdoc b/doc/command_injection.rdoc → doc/security/command_injection.rdoc
diff --git a/doc/security.rdoc → doc/security/security.rdoc b/doc/security.rdoc → doc/security/security.rdoc
diff --git a/doc/string/partition.rdoc b/doc/string/partition.rdoc
@@ -17,7 +17,7 @@ Note that in the examples below, a returned string <tt>'hello'</tt>
 is a copy of +self+, not +self+.
 
 If +pattern+ is a Regexp, performs the equivalent of <tt>self.match(pattern)</tt>
-(also setting {pattern-matching global variables}[rdoc-ref:globals.md@Pattern+Matching]):
+(also setting {pattern-matching global variables}[rdoc-ref:language/globals.md@Pattern+Matching]):
 
   'hello'.partition(/h/)  # => ["", "h", "ello"]
   'hello'.partition(/l/)  # => ["he", "l", "lo"]
@@ -30,7 +30,7 @@ If +pattern+ is a Regexp, performs the equivalent of <tt>self.match(pattern)</tt
 
 If +pattern+ is not a Regexp, converts it to a string (if it is not already one),
 then performs the equivalent of <tt>self.index(pattern)</tt>
-(and does _not_ set {pattern-matching global variables}[rdoc-ref:globals.md@Pattern+Matching]):
+(and does _not_ set {pattern-matching global variables}[rdoc-ref:language/globals.md@Pattern+Matching]):
 
   'hello'.partition('h')     # => ["", "h", "ello"]
   'hello'.partition('l')     # => ["he", "l", "lo"]

diff --git a/doc/string/rpartition.rdoc b/doc/string/rpartition.rdoc
@@ -23,7 +23,7 @@ The pattern used is:
 Note that in the examples below, a returned string <tt>'hello'</tt> is a copy of +self+, not +self+.
 
 If +pattern+ is a Regexp, searches for the last matching substring
-(also setting {pattern-matching global variables}[rdoc-ref:globals.md@Pattern+Matching]):
+(also setting {pattern-matching global variables}[rdoc-ref:language/globals.md@Pattern+Matching]):
 
   'hello'.rpartition(/l/)     # => ["hel", "l", "o"]
   'hello'.rpartition(/ll/)    # => ["he", "ll", "o"]
@@ -36,7 +36,7 @@ If +pattern+ is a Regexp, searches for the last matching substring
 
 If +pattern+ is not a Regexp, converts it to a string (if it is not already one),
 then searches for the last matching substring
-(and does _not_ set {pattern-matching global variables}[rdoc-ref:globals.md@Pattern+Matching]):
+(and does _not_ set {pattern-matching global variables}[rdoc-ref:language/globals.md@Pattern+Matching]):
 
   'hello'.rpartition('l')     # => ["hel", "l", "o"]
   'hello'.rpartition('ll')    # => ["he", "ll", "o"]

diff --git a/doc/syntax/assignment.rdoc b/doc/syntax/assignment.rdoc
@@ -279,7 +279,7 @@ An uninitialized global variable has a value of +nil+.
 
 Ruby has some special globals that behave differently depending on context
 such as the regular expression match variables or that have a side-effect when
-assigned to.  See the {global variables documentation}[rdoc-ref:globals.md]
+assigned to.  See the {global variables documentation}[rdoc-ref:language/globals.md]
 for details.
 
 == Assignment Methods