Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Ruby に関するドキュメントを英語のものと日本語のもので統合する #2887

Open
Paalon opened this issue May 28, 2024 · 3 comments

Comments

@Paalon
Copy link

Paalon commented May 28, 2024

まず、前提として、私は普段 Ruby を書いていないし(Ruby を書く母には育てられました)、Ruby の歴史にも詳しくないし、Ruby のドキュメントの歴史にも詳しくはないです。ですが、外から見て不思議に思ったのでイシューを建てさせてもらいます。

Ruby の公式ドキュメントで Object#class の項目を探そうとしたときに、英語版と日本語版のドキュメントがあることを https://docs.ruby-lang.org/ で知ります。そして英語版のドキュメントの Object の項目で探しますが見当たりません。次に日本語のドキュメントを開くと、英語版と全く異なるスタイル・内容で Object#class の項目も見つかって英語版よりもよく書かれています。Discord の Ruby コミュニティに尋ねたところ、英語版には Kernel#class にその項目があるようだと言われます。どうやら日本語版のドキュメントの方が信頼できそうだということは分かったのですが、ドキュメントの維持の労力が英語と日本語で別々に割かれているのでは、良くないし、英語しかできない人も利用したいねという話になりました。(Kernel#classObject#class の記述のどちらが適切な配置かはあまり Ruby に詳しくないためよく分かっていません。#2664)

Ruby のドキュメントがここ (rerema/doctree) と https://docs.ruby-lang.org/en/3.3/index.html のもの(どこにホストされているのか分からない)の2つに分裂している歴史的背景をあまり知らないので的外れかもしれませんが、どうにか統合もしくは英語版を提供できた方が良い思ったため、このイシューを建てさせていただきました。

@znz
Copy link
Member

znz commented Jun 6, 2024

とりあえず歴史や現状は無視して、どういう状況になったら統合できていると思いますか?

参考にしたいので、多言語版が統合できていると思うようなドキュメントの例はあれば教えてほしいです。

@Paalon
Copy link
Author

Paalon commented Jun 6, 2024

私は普段 Julia をよく触っているのですが、ドキュメントの完成度は低いかもしれませんが(日本語版の充実度は Ruby がプログラミング言語中で1番だと思うので)、Julia のドキュメントの非英語版は大抵英語版と同じスタイルを使っています。

リファレンスではありませんが、Rust のものもスタイルは同じものを使っています。

@Paalon
Copy link
Author

Paalon commented Jun 6, 2024

多言語版をビルドする方法を用意しておいて、あとは翻訳するだけという状態にしておけば、少なくとも英語版と日本語版は統合されていると言えるようにできるのではないでしょうか。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants