Japan-DfinityInfoHub/docs

翻訳の概要と進捗状況

hoosan opened this issue · 44 comments

翻訳プロジェクトに参加するために

ドキュメントの翻訳は以下の手順で進めてください。

  1. 翻訳ページ一覧を確認して、翻訳したい箇所をコメントしてください。
  2. 翻訳する箇所はintroduction/pages/welcome.adocのように指定してください。また、 翻訳箇所は1ページずつでお願いします。
    ただし、翻訳する人が少なく複数宣言しても問題ない場合は複数同時の担当も可とします。
  3. 翻訳する前に、スタイルガイドに目を通してください。
  4. 校正や確認が終わったらプルリクエストを出してください。メンテナーが確認して、問題がなければマージされます。

もし、わからないことや質問等がある場合は Discord の #ドキュメント翻訳チャンネルで質問してください。
なお、宣言してから一定期間(目安:3ヶ月)プルリクエストがない場合には、担当を解除させていただきます。

原文のアップデートに応じた修正

原文のドキュメントがアップデートされたページには、🔀 の記号とプルリクへのリンクが記載されています。
リンク先の diff を参考に翻訳を修正してプルリクを出してください。
修正を開始する前に、修正したい箇所をコメントしてください。

メンテナーへ

コメントの確認からプルリクエストをマージする手順は以下に沿ってください。

コメントを確認した場合

翻訳箇所のコメントを確認した場合、以下のフォーマットに沿って書き換えてください。作業中がわかるように🚀の絵文字をつけてください。この時点ではチェックマークは付けないでください。

こちらは一例です。

- [ ] introduction/pages/welcome.adoc (@hoosan):rocket:

翻訳のレビューが終わった場合

翻訳のチェックが終わってプルリクエストがマージされたら、以下のフォーマットに書き換えてください。
翻訳完了がわかるように🎉の絵文字をつけてください。
マージされた段階でチェックマークをつけるようにしてください。

- [x] introduction/pages/welcome.adoc (@hoosan):tada:

翻訳ページ一覧

ROOT

  • ROOT/pages/download.adoc (@hoosan)🎉
  • ROOT/pages/http-middleware.adoc (@hoosan)🎉
  • ROOT/pages/videos-tutorials.adoc (@hoosan)🎉

Introduction

  • introduction/pages/welcome.adoc (@hoosan)🎉

Samples

Developers guide

  • developers-guide/examples/candid-ui.adoc (@hoosan)🎉
  • developers-guide/pages/basic-syntax-rules.adoc
  • developers-guide/pages/reinstalling-dfx.adoc
  • developers-guide/pages/cli-reference.adoc (@takuryoo) 🎉
  • developers-guide/pages/cli-reference/dfx-build.adoc (@hokosugi) 🎉
  • developers-guide/pages/cli-reference/dfx-cache.adoc (@hokosugi) 🎉
  • developers-guide/pages/cli-reference/dfx-canister.adoc (@hokosugi) 🎉
  • developers-guide/pages/cli-reference/dfx-config.adoc (@hokosugi) 🎉
  • developers-guide/pages/cli-reference/dfx-deploy.adoc (@hokosugi) 🎉
  • developers-guide/pages/cli-reference/dfx-envars.adoc (@hokosugi) 🎉
  • developers-guide/pages/cli-reference/dfx-help.adoc (@hokosugi) 🎉
  • developers-guide/pages/cli-reference/dfx-identity.adoc (@hokosugi) 🎉
  • developers-guide/pages/cli-reference/dfx-ledger.adoc (@hokosugi) 🎉
  • developers-guide/pages/cli-reference/dfx-new.adoc (@hokosugi) 🎉
  • developers-guide/pages/cli-reference/dfx-parent.adoc (@hokosugi) 🎉
  • developers-guide/pages/cli-reference/dfx-ping.adoc (@hokosugi) 🎉
  • developers-guide/pages/cli-reference/dfx-replica.adoc (@hokosugi) 🎉
  • developers-guide/pages/cli-reference/dfx-start.adoc (@hokosugi) 🎉
  • developers-guide/pages/cli-reference/dfx-stop.adoc (@hokosugi) 🎉
  • developers-guide/pages/cli-reference/dfx-upgrade.adoc (@hokosugi) 🎉
  • developers-guide/pages/cli-reference/dfx-wallet.adoc (@hokosugi) 🎉
  • developers-guide/pages/cli-reference/dfx-generate.adoc (@hokosugi) 🎉
  • developers-guide/pages/computation-and-storage-costs.adoc
  • developers-guide/pages/concepts/canisters-code.adoc
  • developers-guide/pages/concepts/concepts-intro.adoc (@tokuryoo) 🎉
  • developers-guide/pages/concepts/data-centers.adoc (@tokuryoo) 🎉
  • developers-guide/pages/concepts/governance.adoc (@numtet) 🎉
  • developers-guide/pages/concepts/nodes-subnets.adoc (@tokuryoo) 🎉
  • developers-guide/pages/concepts/tokens-cycles.adoc (@hoosan)🎉
  • developers-guide/pages/concepts/what-is-IC.adoc (@hoosan)🎉
  • developers-guide/pages/concepts/trust-in-canisters.adoc
  • developers-guide/pages/concepts/bitcoin-integration.adoc
  • developers-guide/pages/customize-projects.adoc (@tokuryoo) 🎉
  • developers-guide/pages/default-wallet.adoc (@tokuryoo) 🎉
  • developers-guide/pages/design-apps.adoc (@tokuryoo) 🎉
  • developers-guide/pages/glossary.adoc (@hoosan)🎉
  • developers-guide/pages/install-upgrade-remove.adoc (@hoosan)🎉
  • developers-guide/pages/lang-service-ide.adoc
  • developers-guide/pages/sample-apps.adoc
  • developers-guide/pages/sdk-guide.adoc (@hoosan)🎉
  • developers-guide/pages/troubleshooting.adoc
  • developers-guide/pages/tutorials/access-control.adoc (@tokuryoo) 🎉
  • developers-guide/pages/tutorials/at-a-glance.adoc
  • developers-guide/pages/tutorials/calculator.adoc (@tokuryoo) 🎉
  • developers-guide/pages/tutorials/counter-tutorial.adoc
  • developers-guide/pages/tutorials/custom-frontend.adoc (@hokosugi) 🎉
  • developers-guide/pages/tutorials/define-an-actor.adoc (@pontagon333) 🎉
  • developers-guide/pages/tutorials/explore-templates.adoc (@pontagon333) 🎉
  • developers-guide/pages/tutorials/hello-location.adoc (@pontagon333) 🎉
  • developers-guide/pages/tutorials/intercanister-calls.adoc (@tokuryoo) 🚀
  • developers-guide/pages/tutorials/multiple-actors.adoc
  • developers-guide/pages/tutorials/multiple-factorial-actors.adoc
  • developers-guide/pages/tutorials/my-contacts.adoc (@hokosugi) 🎉
  • developers-guide/pages/tutorials/phonebook.adoc
  • developers-guide/pages/tutorials/reproducible-builds.adoc
  • developers-guide/pages/tutorials/scalability-cancan.adoc
  • developers-guide/pages/tutorials/simple-cycles.adoc
  • developers-guide/pages/tutorials-intro.adoc (@pontagon333) 🎉
  • developers-guide/pages/webpack-config.adoc (@hokosugi) 🎉
  • developers-guide/pages/work-with-languages.adoc (@hoosan)🎉
  • developers-guide/pages/working-with-canisters.adoc (@pontagon333) 🎉

Integration

  • integration/pages/ledger-quick-start.adoc

Languages

  • languages/pages/languages-overview.adoc (@hoosan)🎉
  • languages/pages/motoko-at-a-glance.adoc (@hoosan)🎉

Operators guide

  • operators-guide/pages/ops-guide.adoc

Quickstart

  • quickstart/pages/local-quickstart.adoc (@gelgoog999) 🎉
  • quickstart/pages/network-quickstart.adoc (@gelgoog999) 🎉
  • quickstart/pages/newcomers.adoc (@gelgoog999) 🎉
  • quickstart/pages/quickstart-intro.adoc (@gelgoog999) 🎉
  • quickstart/pages/quickstart-intro.adoc 🔀 #103 (@hokosugi) 🎉
  • quickstart/examples/vscode-plugin.adoc (@gelgoog999)🎉
  • quickstart/pages/cycles-faucet.adoc (@hokosugi) 🎉
  • quickstart/pages/1-quickstart.adoc (@hokosugi) 🎉
  • quickstart/pages/2-quickstart.adoc (@hokosugi) 🎉
  • quickstart/pages/3-quickstart.adoc (@hokosugi) 🎉
  • quickstart/pages/4-2-convert-ICP-to-cycles.adoc (@hokosugi) 🎉
  • quickstart/pages/4-quickstart.adoc (@hokosugi) 🎉
  • quickstart/pages/5-quickstart.adoc (@hokosugi) 🎉

Release note

  • release-notes/pages/0.6.20-rn.adoc
  • release-notes/pages/0.6.21-rn.adoc
  • release-notes/pages/0.6.22-rn.adoc
  • release-notes/pages/0.6.23-rn.adoc
  • release-notes/pages/0.6.24-rn.adoc
  • release-notes/pages/0.6.25-rn.adoc
  • release-notes/pages/0.6.26-rn.adoc
  • release-notes/pages/0.7.0-rn.adoc
  • release-notes/pages/0.7.1-rn.adoc
  • release-notes/pages/0.7.2-rn.adoc
  • release-notes/pages/0.7.7-rn.adoc
  • release-notes/pages/0.8.0-rn.adoc
  • release-notes/pages/0.8.1-rn.adoc
  • release-notes/pages/0.8.2-rn.adoc
  • release-notes/pages/0.8.3-rn.adoc
  • release-notes/pages/0.8.4-rn.adoc
  • release-notes/pages/0.9.0-rn.adoc
  • release-notes/pages/0.9.2-rn.adoc
  • release-notes/pages/0.9.3-rn.adoc
  • release-notes/pages/sdk-release-notes.adoc

Security best practices

  • security-best-practices/pages/general-security-best-practices.adoc (@hokosugi) 🎉
  • security-best-practices/pages/introduction.adoc (@hokosugi) 🎉
  • security-best-practices/pages/rust-canister-development-security-best-practices.adoc (@hokosugi) 🎉
  • security-best-practices/pages/web-app-development-security-best-practices.adoc (@hokosugi) 🎉

Token holders

  • token-holders/pages/custody-options-intro.adoc (@hokosugi) 🚀
  • token-holders/pages/nns-app-quickstart.adoc (@hokosugi) 🚀
  • token-holders/pages/seed-donations.adoc (@hokosugi) 🚀
  • token-holders/pages/self-custody-quickstart.adoc (@hokosugi) 🚀

Motoko

以下のMotoko に関するドキュメントの翻訳は、Japan-DfinityInfoHub/motoko を fork して実施してください🙏
(Dfinity 公式が、dfinity/motoko にドキュメントを置いているため)

  • language-guide/pages/about-this-guide.adoc (@hoosan)🎉
  • language-guide/pages/actor-classes.adoc (@hoosan)🎉
  • language-guide/pages/actors-async.adoc (@hoosan)🎉
  • language-guide/pages/basic-concepts.adoc (@hoosan)🎉
  • language-guide/pages/caller-id.adoc (@hoosan)🎉
  • language-guide/pages/compiler-ref.adoc (@hoosan)🎉
  • language-guide/pages/control-flow.adoc (@hoosan)🎉
  • language-guide/pages/compatibility.adoc (@hoosan)🎉
  • language-guide/pages/cycles.adoc (@hoosan)🎉
  • language-guide/pages/errors.adoc (@hoosan)🎉
  • language-guide/pages/heartbeats.adoc
  • language-guide/pages/language-manual.adoc
  • language-guide/pages/local-objects-classes.adoc (@hoosan)🎉
  • language-guide/pages/modules-and-imports.adoc (@hoosan)🎉
  • language-guide/pages/motoko-grammar.adoc (@hoosan)🎉
  • language-guide/pages/motoko-introduction.adoc (@hoosan)🎉
  • language-guide/pages/motoko.adoc (@pontagon333) 🎉
  • language-guide/pages/mutable-state.adoc (@hoosan)🎉
  • language-guide/pages/overview.adoc
  • language-guide/pages/pattern-matching.adoc (@hoosan)🎉
  • language-guide/pages/sharing.adoc (@hoosan)🎉
  • language-guide/pages/structural-equality.adoc (@hoosan)🎉
  • language-guide/pages/style.adoc
  • language-guide/pages/upgrades.adoc (@hoosan)🎉

Rust Guide

以下の Rust Guide に関するドキュメントの翻訳は、Japan-DfinityInfoHub/cdk-rs を fork して実施してください🙏
(Dfinity 公式が、dfinity/cdk-rs にドキュメントを置いているため)

  • rust-guide/pages/multiply-dependency.adoc (@hoosan)🎉
  • rust-guide/pages/multiply-dependency.adoc 🔀 #12 (@hoosan)🎉
  • rust-guide/pages/rust-counter.adoc (@hoosan)🎉
  • rust-guide/pages/rust-counter.adoc 🔀 #12 (@hoosan)🎉
  • rust-guide/pages/rust-intro.adoc (@hoosan)🎉
  • rust-guide/pages/rust-optimize.adoc (@hoosan)🎉
  • rust-guide/pages/rust-profile.adoc (@hoosan)🎉
  • rust-guide/pages/rust-profile.adoc 🔀 #12 (@hoosan)🎉
  • rust-guide/pages/rust-quickstart.adoc (@hoosan)🎉
  • rust-guide/pages/rust-quickstart.adoc 🔀 #12 (@hoosan)🎉

Motoko Base

以下の Motoko Base に関するドキュメントの翻訳は、Japan-DfinityInfoHub/motoko-base を fork して実施してください🙏
(Dfinity 公式が、dfinity/motoko-base にドキュメントを置いているため)

  • base-libraries/pages/stdlib-intro.adoc (@hoosan)🎉
  • Array.mo
  • AssocList.mo
  • Blob.mo
  • Bool.mo
  • Buffer.mo
  • CertifiedData.mo
  • Char.mo
  • Debug.mo
  • Deque.mo
  • Error.mo
  • ExperimentalCycles.mo
  • ExperimentalStableMemory.mo
  • Float.mo
  • Func.mo
  • Hash.mo
  • HashMap.mo
  • Heap.mo
  • Int.mo
  • Int16.mo
  • Int32.mo
  • Int64.mo
  • Int8.mo
  • Iter.mo
  • IterType.mo
  • List.mo
  • Nat.mo
  • Nat16.mo
  • Nat32.mo
  • Nat64.mo
  • Nat8.mo
  • None.mo
  • Option.mo
  • Order.mo (@hoosan)🎉
  • Prelude.mo
  • Principal.mo
  • RBTree.mo
  • Random.mo
  • Result.mo
  • Stack.mo
  • Text.mo
  • Time.mo
  • Trie.mo
  • TrieMap.mo
  • TrieSet.mo

Candid Guide

以下の Candid Guide に関するドキュメントの翻訳は、Japan-DfinityInfoHub/candid を fork して実施してください🙏
(Dfinity 公式が、dfinity/candid にドキュメントを置いているため)

  • candid-guide/pages/candid-concepts.adoc (@hoosan)🎉
  • candid-guide/pages/candid-howto.adoc (@hoosan)🎉
  • candid-guide/pages/candid-intro.adoc (@hoosan)🎉
  • candid-guide/pages/candid-ref.adoc (@hoosan)🎉
  • candid-guide/pages/candid-types.adoc (@hoosan)🎉

Internet Identity

以下の Internet Identity に関するドキュメントの翻訳は、Japan-DfinityInfoHub/internet-identity を fork して実施してください🙏
(Dfinity 公式が、dfinity/internet-identity にドキュメントを置いているため)

  • ic-identity-guide/pages/auth-how-to.adoc (@hoosan)🎉
  • ic-identity-guide/pages/auth-how-to.adoc 🔀 #7 #8 (@hoosan)🎉
  • ic-identity-guide/pages/hello-guide.adoc (@hoosan)🎉
  • ic-identity-guide/pages/what-is-ic-identity.adoc (@hoosan)🎉
  • ic-identity-guide/pages/what-is-ic-identity.adoc 🔀 #5 (@hoosan)🎉

Rosetta API

以下の Rosetta API に関するドキュメントの翻訳は、Japan-DfinityInfoHub/ic を fork して実施してください🙏
(Dfinity 公式が、dfinity/ic にドキュメントを置いているため)
ドキュメントの場所は rs/rosseta-api/docs/modules 下です。

  • rosetta-api/pages/deploy-new-token.adoc
  • rosetta-api/pages/ledger-local-setup.adoc
  • rosetta-api/pages/ledger.adoc
  • rosetta-api/pages/neuron-lifecycle.adoc
  • rosetta-api/pages/staking-support.adoc
  • rosetta-api/pages/staking-tutorial.adoc
  • rosetta-api/pages/transfers.adoc (@hoosan)🚀

quickstart/pages/local-quickstart.adoc 書きます

developers-guide/pages/concepts/concepts-intro.adoc 書きます

developers-guide/pages/concepts/nodes-subnets.adoc 書きます。

developers-guide/pages/tutorials-intro.adoc 書きます。

quickstart/pages/quickstart-intro.adoc 書きます。

language-guide/pages/motoko.adoc 書きます。

quickstart/pages/newcomers.adoc 書きます。

quickstart/pages/network-quickstart.adoc 書きます。

developers-guide/pages/tutorials/explore-templates.adoc 書きます。

developers-guide/pages/concepts/data-centers.adoc 書きます。

quickstart/examples/vscode-plugin.adoc 書きます。

developers-guide/pages/tutorials/define-an-actor.adoc 書きます。

integration/pages/ledger-quick-start.adoc 書きます。

developers-guide/pages/cli-reference.adoc 書きます。

developers-guide/pages/tutorials/hello-location.adoc 書きます。

developers-guide/pages/concepts/governance.adoc 書きます

developers-guide/pages/computation-and-storage-costs.adoc 書きます

developers-guide/pages/working-with-canisters.adoc 書きます。

examples/pages/index.adoc 書きます。

developers-guide/pages/tutorials/custom-frontend.adoc を書きます。

docs/developers-guide/tutorials/my-contacts.html の翻訳します。

docs/modules/quickstart/pages/cycles-faucet.adoc
docs/modules/quickstart/pages/host-a-website.adocの翻訳をします。

久しぶりの翻訳ですので軽いところから再開します。

examples/pages/hello.adoc

samples/pages/hackathon-projects.adoc
samples/pages/dao.adoc
samples/pages/dex.adoc

を書きます。

samples/pages/codelabs/simple-nft.adoc
samples/pages/codelabs/static-website.adoc
samples/pages/encrypted-notes.adoc
samples/pages/tokentransfer.adoc
を翻訳します。

samples/pages/nft.adoc を翻訳します。
上記の
samples/pages/codelabs/simple-nft.adoc
samples/pages/codelabs/static-website.adoc
はcodelabsフォルダがすべてHTMLで書かれているため外します。
宜しくおねがいします。

quickstart/pages/1-quickstart.adoc
quickstart/pages/2-quickstart.adoc
quickstart/pages/3-quickstart.adoc
quickstart/pages/4-quickstart.adoc
quickstart/pages/4-2-convert-ICP-to-cycles.adoc
quickstart/pages/5-quickstart.adoc

を翻訳します。宜しくおねがいします。期限は努力目標として5月20日までです。

quickstart/pages/quickstart-intro.adocを翻訳します。

developers-guide/pages/cli-reference/dfx-build.adoc
developers-guide/pages/cli-reference/dfx-cache.adoc
developers-guide/pages/cli-reference/dfx-canister.adoc
developers-guide/pages/cli-reference/dfx-config.adoc
developers-guide/pages/cli-reference/dfx-deploy.adoc

上記を翻訳します。努力目標:6月3日!

developers-guide/pages/cli-reference/dfx-envars.adoc
developers-guide/pages/cli-reference/dfx-generate.adoc
developers-guide/pages/cli-reference/dfx-help.adoc
を翻訳します。目標:6/15

developers-guide/pages/cli-reference/dfx-identity.adocを翻訳します。

developers-guide/pages/design-apps.adoc を翻訳します。

developers-guide/pages/customize-projects.adoc を翻訳します。

developers-guide/pages/cli-reference/dfx-ledger.adoc
developers-guide/pages/cli-reference/dfx-new.adoc
developers-guide/pages/cli-reference/dfx-parent.adoc
を翻訳します。

developers-guide/pages/default-wallet.adoc を翻訳します。

developers-guide/pages/tutorials/access-control.adoc を翻訳します。

developers-guide/pages/cli-reference/dfx-ping.adoc
developers-guide/pages/cli-reference/dfx-replica.adoc
developers-guide/pages/cli-reference/dfx-start.adoc

を翻訳します。

developers-guide/pages/tutorials/calculator.adoc
を翻訳します。

developers-guide/pages/cli-reference/dfx-stop.adoc(済)
developers-guide/pages/cli-reference/dfx-upgrade.adoc
developers-guide/pages/cli-reference/dfx-wallet.adoc

を翻訳します。

security-best-practices/pages/general-security-best-practices.adoc
security-best-practices/pages/introduction.adoc
security-best-practices/pages/rust-canister-development-security-best-practices.adoc
security-best-practices/pages/web-app-development-security-best-practices.adoc

を翻訳します。

developers-guide/pages/tutorials/counter-tutorial.adoc
を翻訳します。

developers-guide/pages/tutorials/intercanister-calls.adoc
を翻訳します。

Token holdersの4つを翻訳します。

  • token-holders/pages/custody-options-intro.adoc
  • token-holders/pages/nns-app-quickstart.adoc
  • token-holders/pages/seed-donations.adoc
  • token-holders/pages/self-custody-quickstart.adoc

developers-guide/pages/tutorials/intercanister-calls.adoc
取り下げます。