I think that's a good idea for the next time we have cycles to put into
improving these.  Right now, I just want to make them available, and ensure
that usage notes I've encountered are recorded.

Unless you mean why is there a README.md at all, rather than just a pair of
header comment blocks into the two scripts...and that gets back to whether
util/ is a good spot -- I don't want to confuse people into thinking that
these scripts are meant for any kind of production activity.  So a
README.md of why the directory exists seemed like a good idea..


On Tue, Jul 23, 2013 at 11:26 AM, Adrien Thebo <notifications@github.com>wrote:

> In util/README_UTIL.md:
>
> > @@ -0,0 +1,57 @@
> > +Development Utilities
> > +=====================
> > +
> > +The scripts in this directory are utility scripts useful during development.
> > +
> > +binary_search_specs.rb
>
> Why isn't this documentation in the script itself?
>
> —
> Reply to this email directly or view it on GitHub<https://github.com/puppetlabs/puppet/pull/1788/files#r5352654>
> .
>



-- 
Josh Partlow
Developer, Puppet Labs