Permalink
Browse files

Extended and clarified intro section of i18n guide.

  • Loading branch information...
1 parent 74fd2d3 commit 0eccdd9fb6a0e4df2904b28906fd5e7598266aa9 @karmi karmi committed Jan 22, 2009
Showing with 9 additions and 2 deletions.
  1. +9 −2 railties/doc/guides/source/i18n.txt
@@ -1,9 +1,16 @@
The Rails Internationalization (I18n) API
=========================================
-The Ruby I18n (shorthand for _internationalization_) gem which is shipped with Ruby on Rails (starting from Rails 2.2) provides an easy-to-use and extensible framework for translating your application to a single custom language other than English or providing multi-language support in your application.
+The Ruby I18n (shorthand for _internationalization_) gem which is shipped with Ruby on Rails (starting from Rails 2.2) provides an easy-to-use and extensible framework for *translating your application to a single custom language* other than English or for *providing multi-language support* in your application.
-NOTE: The Ruby I18n framework provides you with all neccessary means for internationalization/localization of your Rails application. You may, however, use any of various plugins and extensions available. See Rails http://rails-i18n.org/wiki[I18n Wiki] for more information.
+In the process of _localizing_ your application you'll probably want to do following two things:
+
+* Replace or supplement Rail's default locale -- eg. date and time formats, month names, ActiveRecord model names, etc
+* Abstract texts in your application into keyed dictionaries -- eg. flash messages, static texts in your views, etc
+
+This guide will walk you through the I18n API and contains a tutorial how to internationalize a Rails application from the start.
+
+NOTE: The Ruby I18n framework provides you with all neccessary means for internationalization/localization of your Rails application. You may, however, use any of various plugins and extensions available, which add additional functionality or features. See Rails http://rails-i18n.org/wiki[I18n Wiki] for more information.
== How I18n in Ruby on Rails works

0 comments on commit 0eccdd9

Please sign in to comment.