From: Zachary Scott <e@...>
Date: 2013-10-09T12:51:47+00:00
Subject: [ruby-core:57770] Re: [ruby-trunk - Feature #8636] Documentation	hosting on ruby-lang.org

Hello Okkez, Thanks for your feedback!


On Oct 8, 2013, at 10:13 PM, okkez (okkez _) <redmine@ruby-lang.org> wrote:
>> 
>> I think docs.ruby-lang.org/en will be default for now, as we add more translations we can list them on: docs.ruby-lang.org/
> 
> I think docs.ruby-lang.org/ will show links to other languages.
> (See doc.ruby-lang.org. It's very very simple page I craeted;-))
> Because there is a RUREMA (Japanese version of reference manual).
> And we have many tasks to publish i18n docs, so we can describe tasks on docs.ruby-lang.org/.
> 

Agree that docs.ruby-lang.org/ should list translations, similar to your page on doc.ruby-lang.org!

>> If you check rake task I wrote I plan to support stable versions only, ie: docs.ruby-lang.org/en/ruby_1_9_3/
> 
> I prefer the URI like docs.ruby-lang.org/en/1.9.3/ instead of yours.
> Because we can guess URI for available versions.
> I think that many light users don't know stable branch name.
> We have Japanese version URI such as http://doc.ruby-lang.org/ja/2.0.0/
> 

For this we need to update my Rakefile to gsub 'ruby_1_9_3' to '1.9.3' to initialize the repository via "git clone", such as:

branch = ruby_1_9_3
version = branch.gsub('ruby_', '').gsub('_', '.')
`git clone --branch=#{branch} git://github.com/ruby/ruby.git version`

As of now we are using directory task for #{source_dir} as branch name.

btw, the Rakefile is here: https://github.com/zzak/docs.ruby-lang.org/blob/master/Rakefile

> Which subdomain do you like? doc or docs.
> For now, doc.ruby-lang.org is available.
> 

I like docs subdomain


Thank you!