This project is archived and is in readonly mode.
Improve Rails README
Reported by Matt Di Pasquale | May 31st, 2010 @ 08:38 PM
Keep the meaning & technical details the same, but fix:
- capitalization, spelling, punctuation, grammar, spacing, etc. -
text width to 80 columns max.
Matt
Comments and changes to this ticket
-
Matt Di Pasquale May 31st, 2010 @ 08:42 PM
- no changes were found...
-
Matt Di Pasquale May 31st, 2010 @ 09:05 PM
- Tag changed from readme to patch, readme
By running
rake update_readme
from the railties directory, I copied the changes I made in railties/README to railties/lib/rails/generators/rails/app/templates/README. So, please only review the former. That's the top half of the attached patch file.Thanks!
Matt
-
Jason Gignac May 31st, 2010 @ 09:35 PM
A few comments:
Rather than:
+By default, Rails will try to use Mongrel if it's installed when started with +rails server, otherwise Rails will use WEBrick, the web server that +ships with Ruby.Do you think the phrasing might be easier as:
If Mongel is installed, Rails will try to us it when started with rails server. Otherwise, by default Rails will use WEBrick, the web server that ships with Ruby. Rails can also be configured to use a number of other web servers.Also, when you say:
If you have Ruby Gems installed, getting up and running with mongrel is as easy as: sudo gem install mongrel.I would suggest that it might be better to simply specify:
gem install mongrelas specifying 'sudo' might be a bit overly prescriptive, perhaps?
Next, with:
+You can alternatively run Rails applications with other Ruby web servers,...Is there a guide or documentation on HOW to run Rails with other web servers? If so, perhaps it would be good to put a link here?
There are also a number of corrections such as the following where the only difference between yours and the original (I think?) is the line widths. Is there a standard that you are tryin to approximate here?
-These two online (and free) books will bring you up to speed on the Ruby language -and also on programming in general. +These two online (and free) books will bring you up to speed on the Ruby +language and also on programming in general.In the following correction did you meant to drop the tt tags?
test - Unit and functional tests along with fixtures. When using the rails generate scripts, template - test files will be generated for you and placed in this directory. + Unit and functional tests along with fixtures. When using the rails generate + command, template test files will be generated for you and placed in this + directory.Otherwise a GREAT job of editing :)
-
Michael Koziarski June 2nd, 2010 @ 09:04 AM
- Assigned user set to Xavier Noria
-
Rizwan Reza June 5th, 2010 @ 01:03 AM
- State changed from new to resolved
-
Repository June 5th, 2010 @ 02:11 AM
(from [1535b02a9f8e0eaa3cd3182a45d2bd7855c3809c]) Improve Rails README [#4740 state:resolved]
Signed-off-by: Rizwan Reza rizwanreza@gmail.com
http://github.com/rails/rails/commit/1535b02a9f8e0eaa3cd3182a45d2bd...
Create your profile
Help contribute to this project by taking a few moments to create your personal profile. Create your profile »
<h2 style="font-size: 14px">Tickets have moved to Github</h2>
The new ticket tracker is available at <a href="https://github.com/rails/rails/issues">https://github.com/rails/rails/issues</a>
People watching this ticket
Attachments
Referenced by
- 4740 Improve Rails README (from [1535b02a9f8e0eaa3cd3182a45d2bd7855c3809c]) Improve...