what's the difference between rails/rails and rails/docrails?

rubyonrails-docs
#1

I’ve found two guide’s source:

https://github.com/rails/rails/tree/master/guides/source

and

https://github.com/rails/docrails/tree/master/guides/source

don’t understand why? if I’m willing to translate guides to another language, which one should I fork as a starting point?

#2

rails/rails is “the” Rails repository. It’s where people commit code into Ruby on Rails.

rails/docrails is a copy of rails/rails. This lets people to push documentation patches (write access for which is doled out by the core team) without the need to send in pull requests. We merge rails/docrails into rails/rails and vice versa once in a week or a fortnight. More on this can be found at http://weblog.rubyonrails.org/2013/6/14/docrails-back-to-the-roots/

I think we don’t want to maintain localized copies of the guides in the repo, but I’ll let Xavier (fxn on github if you’d like to ping him) answer this.

We do however support generating the guides in different languages locally - https://github.com/rails/rails/blob/master/guides/rails_guides/generator.rb#L41

Hope this is helpful.

Regards

Vijay

#3

Yes, we don’t maintain translations.

Reason is we strongly believe docs have to be updated alongside code. A complete patch has code, test coverage, and update affected docs. Is the way to keep your test suite and documentation in sync with the code base.

And in practice that is only going to work with English.