Important
このレポジトリはアーカイブされたので、新規のIssueやPull Requestは受け付けていません。 OpenTelemetryのドキュメントとウェブサイトのローカライズはウェブサイトのレポジトリで行っています。
This repository is archived and will not receive any updates or accept issues or pull requests
Localizations for the OpenTelemetry documentation and website are now part of the website repository
OpenTelemetry documents Japanese translation poject
- community
- 67d8f20a8b0cb49e3fd9033545c3f9e5865de7cf (2021-02-11バージョン)
- specification
- v1.3.0
翻訳プロジェクトへようこそ。この翻訳プロジェクトでは、全体的に翻訳に統一感を出すための工夫をしています。
- 訳語一覧: wikiのDictionary で英語と日本語の対訳の一覧を作成しているので、翻訳時にこちらに揃えてください。
- 助動詞について: 原文はBCP 14に準ずると明記しているので、日本語訳もそれに従います。
TODO: textlintなどの方法である程度自動化する
機械翻訳を利用して翻訳作業を行うことは技術の正しい利用方法だと思います。 しかしながら、サービスによっては次のような問題があるため注意が必要です。
- 翻訳結果の著作権（例: DeepL無料版、Google翻訳など）
- 翻訳結果自体の品質
したがって、機械翻訳を利用する場合には、上記の懸念が明確にないと確認できる状況以外では、機械翻訳による翻訳結果をそのままレポジトリにpushすることは避けてください。（各種サービスがCNCFのCLAにサインしたわけでもないため）
- Issueより対象のドキュメントに対し作業に取り掛かる旨コメントしてください。
- 作業ドキュメントは原文の英語ドキュメントをコピーし、翻訳を進めるにあたりそれをコメントアウトする形で勧めてください。(参考)
- 作業中は
WIPをつけたブランチを作成しPRを早めに出してください。 - Reviewerがレビューを行ってapproveされるまで修正をお願いします。
- ApproveされたものはCODEOWNERSの誰かがsquash mergeします。
もし翻訳等で質問がある場合はIssueでコメントしてください。
翻訳プロジェクトのチャットはこちらのdiscordの #otel-docs-ja チャンネルで行っています。
よりオープンなプロジェクトにするために、オープンな定期ミーティングを計画しています。