= Welcome to Globalize =

'''Globalize''' is a '''Ruby on Rails''' plugin designed to support '''multilingual''' applications. It’s under the [wiki:MIT] License, same as Ruby on Rails.

Check out the main wiki at: http://wiki.globalize-rails.org

== Checking out the source ==

HTTP access to repository is currently disable and will come by the end of month. Please use this url until this date :

{{{
  svn://svn.globalize-rails.org/globalize/trunk
}}}

== Creating a patch ==

Tickets are fine, but patches are great. If you want to modify Globalize or fix a bug you've run across, there's no faster way to make it happen than to do it yourself. Globalize and Rails thrives on the generous work of contributors from around the world. Please become one of them.

 1. '''Get Globalize Rails ready for patching'''
   1. Check out the latest source: svn co svn://svn.globalize-rails.org/globalize/trunk
   2. Ensure that your rails version is 1.1.x
   3. Ensure that the existing unit tests pass.
 2. '''Make a test-driven change'''
   1. Add or change unit tests to prove that your change works.
   2. Make the change to the source.
   3. Verify that all tests pass by running rake test:plugins. See rake --tasks for more. 
 3. '''Share your well-tested change'''
   1. Sanity check the changes you've made: svn status
   2. Create a patch: svn diff > my_descriptively_named_patch.diff
   3. Create a new ticket with [PATCH] as the first word in the summary. Attach your patch file.
   4. Keep an eye on the ticket and address concerns that arise. Make your change hard not to commit. 
   5. Bask in the glory of being a Globalize Rails contributor! 

== Source style ==

 * Two spaces, no tabs
 * Don't use '''and''' and '''or''' for boolean tests, instead always use '''&&''' and '''`||`'''
 * MyClass.my_method(my_arg) -- not my_method( my_arg ) or my_method my_arg
 * Follow the conventions you see used in the source already 

(This great introduction is a copy/paste from http://dev.rubyonrails.org/)