Charter

Hyperledger Fabric Japanese Documentation Working Group.

Hyperledger Fabric 日本語ドキュメントのワーキンググループです。

Scope

The purpose of this group is to translate the Hyperledger Fabric documentation to Japanese.  This documentation will be synchronized, beginning with the latest LTS version of Hyperledger Fabric (Version 2.2) which is going to be released on July 2020.

このグループの目的は、Hyperledger Fabricドキュメントを日本語へ翻訳することです。ドキュメントは、2020年7月リリース予定のLTS最新バージョンのHyperledger Fabric (Version 2.2)を元に、同期していきます。

Links to Ongoing Work

The original online documentation is: http://hyperledger-fabric.readthedocs.io/

オリジナルのオンラインドキュメントはこちら：http://hyperledger-fabric.readthedocs.io/

The translation Github repository is: https://github.com/hyperledger/fabric-docs-i18n/tree/master/docs/locale/ja_JP

翻訳用Githubリポジトリはこちら：https://github.com/hyperledger/fabric-docs-i18n/tree/master/docs/locale/ja_JP

Ways to contribute

There are many ways you can contribute to the translation, both as a reviewer/translator and a technical supporter.

翻訳への貢献には2つの方法があります。具体的には、レビュア/翻訳者と技術サポートです。このWikiページの下にあるMembersテーブルの右側2列に、希望する役割を記入してください。

（Wikiページの編集は、LinuxFoundationのIDが必要です。どなたでもご自由に登録いただけます。）

1. role：reviewer（査読者）、translator（翻訳者）またはその両方の記入をお願いいたします。

翻訳は基本的にダブルチェックをして、reviewerにマージしていただきます。reviewerは翻訳作業ができないというわけではありません。他のreviewerにチェックをお願いしてください。

なお、ダブルチェックは翻訳品質を保つ目的もありますので、reviewerになる方は、Fabricのご経験やLinuxFoundation発行の資格がある方にお願いしたいと思います。

2. technical support：技術面（githubや翻訳ツールの使い方など）のサポートを引き受けてくださる方はyesを記入ください。

具体的なフォロー内容はまだ決まっていませんが、毎週のミーティング以外で、ツールの使い方のレクチャーをしたり、チャットでフォローをお願いしたりすることを考えています。

Contributing Guideline

Please read the contributing guideline before staring translation. You will find how to make changes and how to use GitHub.

翻訳作業を始める前に、コントリビューションガイドを参照ください。ドキュメントの変更方法やGitHubの使い方を学ぶことができます。

Contributing documentation: https://hyperledger-fabric.readthedocs.io/en/master/CONTRIBUTING.html#contributing-documentation
GitHub Contributions: https://hyperledger-fabric.readthedocs.io/en/master/github/github.html

Project Management

We use GitHub issues and milestone for project management.

githubにファイル/フォルダごとのissueを設定しますので、issueのコメント欄に翻訳着手する旨の申告をお願いいたします。githubのマイルストーンで全体の進捗管理をする予定です。

Target topics

The link below shows documents which should be translated first.

最初に翻訳すべきドキュメントが下記リンクに示されています。ここから優先的に翻訳します。First topics(Introduction, Contribution, Glossary)が翻訳できたら、Read the Docで日本語のページを公開することができます。

https://hyperledger-fabric.readthedocs.io/en/master/international_languages.html#first-topics

https://hyperledger-fabric.readthedocs.io/en/master/international_languages.html#suggested-next-topics

Translation Flow

TBD. This slide show a draft.

翻訳フローを現在議論中です。こちらのスライドはドラフトです。

また、zoomミーティングで下記フローを実際に実行しながら確認したときのビデオが2020 08 04 JPDWG Agendaにありますので、ご参考いただければ幸いです。もし、翻訳以外の部分（ツールの使い方、コマンド、インストールなど）でお困りのことがありましたら、Membersテーブルの"technical support : yes"の方または、チャットへお気軽にお問い合わせください。

Translation tools

みんなの自動翻訳 TexTra（このツールの使用は必須ではありません。）

https://mt-auto-minhon-mlt.ucri.jgn-x.jp

翻訳にあたっては、下記の用語、対訳データを参考に翻訳をお願いいたします。

https://github.com/linuxfoundation-jp/HL_Fabric_Doc-Jp

Translation Rules 

翻訳の過程で蓄積されていくテクニックや予めルール／方針を統一しておいた方が手間がかからなくて皆が幸せになるような事項を以下にまとめる。

翻訳範囲

日本語文章統一ルール

表記ゆれを防ぐために本WGが定める基本的な日本語文章のルールです。

Issue/Pull Request発行

PR投稿前のセルフチェックリスト 

本家から引き継いでいるWARNING一覧

release-2.2においては、本家から引き継いで以下のchecking consistency WARNINGが発生しています（2020年8月13日時点）。これらはどこからもリンクが張られていないために発生している警告となります。

日本語翻訳時には、これらは警告については無視してください。

• source/build_network.rst: WARNING: document isn't included in any toctree
• source/developapps/apis.md: WARNING: document isn't included in any toctree
• source/github/github.rst: WARNING: document isn't included in any toctree
• source/ledger.rst: WARNING: document isn't included in any toctree
• source/msp-identity-validity-rules.rst: WARNING: document isn't included in any toctree
• source/policies.rst: WARNING: document isn't included in any toctree
• source/security_model.rst: WARNING: document isn't included in any toctree
• source/tutorial/installxcode.md: WARNING: document isn't included in any toctree

Meetings

Meetings by JPDWG

Chatting / Inquiries

We share our activities, workings and inquiries in this chat channel. If you have any questions or problems about the project, please feel free to comment on it in Japanese.

こちらのチャットチャンネルで活動、作業、お問い合わせなどの共有をします。もし、プロジェクトについて何か質問や問題があれば、こちらに遠慮なく日本語でコメントください。

https://chat.hyperledger.org/channel/fabric-docs-japanese

Members

Release Fabric-2.2 Volunteers

Please feel free to provide your name and contact information below.