From: Eric Hodel <drbrain@...7.net>
Date: 2013-02-19T14:06:18+09:00
Subject: [ruby-core:52512] Re: Should I document refinements in a PickAxe update?

On Feb 18, 2013, at 19:58, Dave Thomas <dave@pragprog.com> wrote:

> Gentle core folk:
> 
> I'm updating the PickAxe for Ruby 2, and I'd like your wisdom.
> 
> I know that the current RC has file-level refinements in it. 
> 
> However, I also know that things are likely to change.
> 
> So, my question is: should I document what is there now, or would it be better to wait? I'm a little nervous that if I document the current way it works, it might make it a little harder to change later without breaking backwards compatibility.
> 
> What do you all think?

I created this document:

https://github.com/ruby/ruby/blob/trunk/doc/syntax/refinements.rdoc

From the spec:

http://bugs.ruby-lang.org/projects/ruby-trunk/wiki/RefinementsSpec

I think a document in a PickAxe update with appropriate warnings would help us get feedback on refinements.