From: Dave Thomas <dave@...>
Date: 2013-02-19T12:58:39+09:00
Subject: [ruby-core:52508] Should I document refinements in a PickAxe update?

--047d7b6226a4528ac604d60bbd43
Content-Type: text/plain; charset=UTF-8

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?



Dave

--047d7b6226a4528ac604d60bbd43
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

Gentle core folk:<div><br></div><div>I&#39;m updating the PickAxe for Ruby =
2, and I&#39;d like your wisdom.</div><div><br></div><div>I know that the c=
urrent RC has file-level refinements in it.=C2=A0</div><div><br></div><div>=
However, I also know that things are likely to change.</div>

<div><br></div><div>So, my question is: should I document what is there now=
, or would it be better to wait? I&#39;m a little nervous that if I documen=
t the current way it works, it might make it a little harder to change late=
r without breaking backwards=C2=A0compatibility.</div>

<div><br></div><div>What do you all think?</div><div><br></div><div><br></d=
iv><div><br></div><div>Dave</div>

--047d7b6226a4528ac604d60bbd43--