Just a small question, would it make sense to have the readme of the gem
at
least link to the Rails guide about
I18nhttp://guides.rubyonrails.org/i18n.html?
This is all completely my personal opinion, but trying to think like a
person not familiar with i18n, the first problem I find is no
documentation
in the Readme. There’s a list of features, but no code whatsoever. Even
the
simplest example would help:
es.yml
es:
hello: “Hola”
en.yml
en:
hello: “en”
I18n.locale = :es
I18n.t :hello # => “Hola”
The second problem is that the only link to documentation is to the
wiki,
which even though it looks quite improved, there’s again still no code
and
no examples, and the guides aren’t even in the first set of links. An
introduction paragraph linking to the rails guide as the most complete
(even
when rails focused) would do much.
Again, this is all an opinion, but I’ve been asked quite basic questions
about I18n the last weeks which are fully answered in the rails guides
and
that makes me think people just aren’t finding it. Another small matter
would be that in the Rails guides page, the guide about i18n is called
“Rails internationalization guide”, which is corrrect, but at least I
always
go looking for “I18n” when trying to find stuff about I18n, and not
“internationalization”.
What do you think?
{ :name => “Albert L.” }