[ruby-core:57755] [ruby-trunk - Feature #8636] Documentation hosting on ruby-lang.org

Issue #8636 has been updated by okkez (okkez _).


Sorry for my late response.
I couldn't notice this issue.

zzak (Zachary Scott) wrote:
> Hello!
>  
>  > On Oct 7, 2013, at 11:10 AM, "kou (Kouhei Sutou)" <[e-mail]> wrote:
>  > 
>  >> For now, I think we should just have docs.ruby-lang.org be the english documentation site. However, I'd like more feedback from the RUREMA team. Could you ping okkez and sutou-san?
>  > 
>  > Does it mean that you put http://docs.ruby-lang.org/ to English documentation? Or http://docs.ruby-lang.org/en/?
>  > http://docs.ruby-lang.org/en/ is OK to me.
>  
>  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/.

>  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/

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

Thanks.
----------------------------------------
Feature #8636: Documentation hosting on ruby-lang.org
https://bugs.ruby-lang.org/issues/8636#change-42355

Author: zzak (Zachary Scott)
Status: Feedback
Priority: Normal
Assignee: zzak (Zachary Scott)
Category: doc
Target version: 


We discussed whether RDoc documentation should be hosted on ruby-lang.org.

What domain should we use to host api documentation for Ruby?
ie: (docs|rdoc|ref).ruby-lang.org

IRC Developers Meeting Log:
https://bugs.ruby-lang.org/projects/ruby/wiki/DevelopersMeeting20130712#Documentation-hosted-on-ruby-langorg-zzak

I am partial to docs.ruby-lang.org, but open to feedback ofcourse.


-- 
http://bugs.ruby-lang.org/