Contributing to Ruby

This repository (in fact, just README) contains and tracks my (zverok aka Victor Shepelev) contributions to discussing/changing of the Ruby programming language. It links to Ruby bug tracker discussions of things I've contributed and proposed and their current status. Rejected/ignored proposals are eventually removed from the list.

Goals of this list is:

• Public tracking of this part of my work (it is not easy in Redmine to summarize what are currently in progress and what is solved and how);
• Encouragement for others to participate in Ruby development: hopefully, my example will show that it is possible and meaningful for any of us to make a difference;
• Exposure of my work on Ruby, however insignificant it is: with primary Ruby development being led in Redmine and SVN, it is pretty hard to point at "what exactly I did", and, well, I am mere mortal and sometimes just being proud.

Ruby features

Accepted

• master:
  • Enumerable#compact and Enumerator::Lazy#compact
• Ruby 3.0:
  • Symbol#to_proc lambdiness
  • Array slicing with ArithmeticSequence
• Ruby 2.7:
  • Comparambe#clamp with a range: 1.clamp(0..100), 1.clamp(5..), 1.clamp(..18)
  • Enumerator#produce
  • Beginless range
  • Method#inspect
  • Date#inspect simplified (reverted)
• Ruby 2.6:
  • Kernel#then as a synonym (better name) for #yield_self (context)
  • Enumerable#chain
  • Range#=== to use cover? instead of include?
  • CSV::Row#each_pair for compatibility with OpenStruct

Pending

• Struct::Value immutable value object
• Dir#empty? and File#empty?
• Pattern matching deconstruction for various core objects
• Object#non
• Documentation backporting problem

Contributed to discussions

(The cases where I was not an author of initial proposal, but believe my contribution/pushing for solution was significant enough)

• 3.0: Hash#except
• 2.7: Syntax sugar for method reference: seems .: is finally accepted for 2.7 (ugh, reverted)
• 2.5: Kernel#yield_self -- I don't like the name, but for several months pushed for "we should have this method, whatever name you choose" :) Then we renamed it to #then in 2.6

Minor clarifications and bugs

• 3.0 Object.clone(freeze: true)
• 2.7 Deprecate Kernel#open provided by open-uri in favor of more explicit URI.open
• 2.7 Time#dst? bug for time with real timezone
• 2.7 IO#set_encoding_by_bom raising on already set encoding
• StringIO#internal_encoding is broken
• Necessity of require 'fiber'

Documenting Ruby

Merged

• 3.0:
  • Full docs for non-blocking Fibers and scheduler
  • New docs for Fiber.transfer
  • Full class- and method-level docs for Ractors
  • Update method definition docs to include ... and one-line methods
  • group of small fixes in 3.0 core docs
  • JSON: hide irrelevant parts of docs
  • JSON: enhance generic JSON and #generate docs
• Ruby 2.7:
  • Kernel#system(exception: true)
  • NoMethodError/NameError new arguments
  • Kernel#BigDecimal(exception: false)
  • BigDecimal::Jacobian -- fix invisible docs
  • TracePoint#enable
  • Enumerator::Lazy
  • fileutils: facelift module docs and fix some bugs;
  • group of small fixes of formatting in core docs
  • group of larger fixes: toplevel return, full comments syntax explanation, rescue in blocks, better docs for chomp: option, Object#to_enum, Proc#>> and #<<, Process module
  • Matrix: slightly enhance docs
  • group of stdlib documentation fixes: ERB, StringIO, IRB, Net::FTP, open-uri, OptionParser, Net::HTTP
  • Bundler entire stdlib
  • Webrick: document Proc body for Response
  • Numbered block parameters
  • Small final pre-2.7 changes
  • Module#const_source_location
  • RubyVM.resolve_feature_path (the feature is moved to $LOAD_PATH)
  • Pattern matching
• Ruby 2.6:
  • &.
  • Kernel#yield_self
  • Method
  • YAML (explanation of aliasing to Psych)
  • MatchData
  • Proc
  • Endless range
  • Integer(exception: false) and others
  • Tempfile
  • Psych#dump
  • CSV: redesign main class docs

Pending

—