Re: [pt-workshops] Curriculum materials {was Railsbridge materials}

[Igal Koshevoy]

I've reviewed the final piece of curriculum that we'd talked about using...

Ruby Guides "Getting Started" at
http://guides.rubyonrails.org/getting_started.html -- Introduces
advanced Rails concepts, describes earlier content in greater detail,
and offers hands-on coding through cut-and-paste instructions.
Exercise takes 1.5 to 4 hours, but participants can continue improving
their sample application further for as long as they want. Only
notable problem with the guide is that it doesn't clearly indicate
what's added or changed between instructions in the sample code.

-igal

[Igal Koshevoy]

On Thu, Aug 11, 2011 at 12:09 AM, Igal Koshevoy <ig...@pragmaticraft.com> wrote:
> Ruby Guides "Getting Started" at
> http://guides.rubyonrails.org/getting_started.html -- Introduces
> advanced Rails concepts, describes earlier content in greater detail,
> and offers hands-on coding through cut-and-paste instructions.
> Exercise takes 1.5 to 4 hours, but participants can continue improving
> their sample application further for as long as they want. Only
> notable problem with the guide is that it doesn't clearly indicate
> what's added or changed between instructions in the sample code.

I've come up with a patch that fixes the above issue, it adds
highlighting to indicate the lines of code modified by the guide's
instructions, you can see it at
https://github.com/igal/docrails/compare/master...with_highlighting

You can try this by cloning my repo, checking out the
`with_highlighting` branch, run `(cd railties && rake
generate_guides)`, and open
"railties/guides/output/getting_started.html" in a web browser and
look for the yellow highlighting in the code sections.

I'll work on getting this ported and accepted into the Rails 3.0 and
3.1 guides. If this can't be merged by the time of the workshop, I can
host the modified documentation for the attendees.

-igal