From cmdjackryan at gmail.com  Tue Feb 19 06:04:55 2013
From: cmdjackryan at gmail.com (Phillip Gawlowski)
Date: Tue, 19 Feb 2013 07:04:55 +0100
Subject: [Rubyinstaller-devel] Tackling README.txt
Message-ID: <CABwKMH2vEN=7YRVL=LdvuKAU7tW1S4fY6dPrz60s=7k8LJ7BrQ@mail.gmail.com>

Howdy, y'all.

I'm considering tackling re-writing the README for the RubyInstaller, and
would like to know what should be included.

Without a lot of pondering on my end, I saw the following to revise, in no
particular order:

1.) Markdown syntax, for nice GitHub formatting
2.) Add basic compilation instructions (an idea for the website, too. Took
me ages to figure out that I should consult the README) and replace the
Quick Start
3.) Update the instructions for Ruby 1.9, and relegate 1.8 instructions to
a secondary position
4.) More links (Google Group, GitHub, RubyInstaller itself)

Thoughts, feedback, cross-post to RubyInstaller, too?
-- 
Phillip Gawlowski

gplus.to/phgaw | twitter.com/phgaw

A method of solution is perfect if we can forsee from the start,
and even prove, that following that method we shall attain our aim.
              -- Leibniz
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://rubyforge.org/pipermail/rubyinstaller-devel/attachments/20130219/af558da5/attachment.html>

From luislavena at gmail.com  Tue Feb 19 12:48:22 2013
From: luislavena at gmail.com (Luis Lavena)
Date: Tue, 19 Feb 2013 09:48:22 -0300
Subject: [Rubyinstaller-devel] Tackling README.txt
In-Reply-To: <CABwKMH2vEN=7YRVL=LdvuKAU7tW1S4fY6dPrz60s=7k8LJ7BrQ@mail.gmail.com>
References: <CABwKMH2vEN=7YRVL=LdvuKAU7tW1S4fY6dPrz60s=7k8LJ7BrQ@mail.gmail.com>
Message-ID: <CAN_J9av4Dz-KY5t_w5SumAncNyR3QqjQijaJTSe6Yvazf=Yd0Q@mail.gmail.com>

On Tue, Feb 19, 2013 at 3:04 AM, Phillip Gawlowski
<cmdjackryan at gmail.com> wrote:
> Howdy, y'all.
>

Hello Phillip, long time no see!
(worth mention you're sending this to RubyForge list, not Google Group)

> I'm considering tackling re-writing the README for the RubyInstaller, and
> would like to know what should be included.
>

That will be awesome!, you can simply start a pull request and we can
do the review process there.

> Without a lot of pondering on my end, I saw the following to revise, in no
> particular order:
>
> 1.) Markdown syntax, for nice GitHub formatting

Good

> 2.) Add basic compilation instructions (an idea for the website, too. Took
> me ages to figure out that I should consult the README) and replace the
> Quick Start

If you think README needs to be split into multi documents to cover
all the scenarios, don't hesitate, Now GitHub supports markdown
linking between them, so will be more easy.

> 3.) Update the instructions for Ruby 1.9, and relegate 1.8 instructions to a
> secondary position

Yup, for the record, all the latest builds have been done using Ruby
1.9.3. Considering 1.8.7 is near EOL, will be great if we can start
killing it from our documentation ;-)

> 4.) More links (Google Group, GitHub, RubyInstaller itself)
>

That will be good too, specially a note that the issues section in
GitHub is about RubyInstaller itself (the installer, the dependencies)
and not Ruby, links to Ruby bug tracker will be helpful too.

> Thoughts, feedback, cross-post to RubyInstaller, too?

Actually you should post this to RubyInstaller group, since rubyforge
list has been deprecated. I'm cross-posting this to RubyInstaller
already ;-)

But your objects are great and I'm looking forward to read them (and
merge them!)

Cheers,

> --
> Phillip Gawlowski
>
> gplus.to/phgaw | twitter.com/phgaw
>
> A method of solution is perfect if we can forsee from the start,
> and even prove, that following that method we shall attain our aim.
>               -- Leibniz
>
> _______________________________________________
> Rubyinstaller-devel mailing list
> Rubyinstaller-devel at rubyforge.org
> http://rubyforge.org/mailman/listinfo/rubyinstaller-devel



-- 
Luis Lavena
AREA 17
-
Perfection in design is achieved not when there is nothing more to add,
but rather when there is nothing more to take away.
Antoine de Saint-Exup?ry