Skip to content

日本語版 (ja) #4

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

Closed
31 of 34 tasks
koriym opened this issue Feb 21, 2022 · 26 comments · Fixed by #59 or #81
Closed
31 of 34 tasks

日本語版 (ja) #4

koriym opened this issue Feb 21, 2022 · 26 comments · Fixed by #59 or #81
Assignees
Labels
good first issue Good for newcomers ja

Comments

@koriym
Copy link
Member

koriym commented Feb 21, 2022

Related: #19

  • Installation
  • Overview
  • Motivation
  • Getting Started
  • Mental Model
  • Scopes
  • Bindings
  • ・Linked Bindings
  • ・Binding Attributes
  • ・Instance Bindings
  • ・Provider Bindings
  • ・Untargeted Bindings
  • ・Constructor Bindings
  • ・Built-in Bindings
  • ・Multibindings
  • ・Contextual Bindings
  • ・Null Object Bindings
  • Injections
  • ・Injecting Providers
  • Object Life Cycle
  • AOP
  • Graphing Applications
  • Integration
  • Backward Compatibility

Best Practice (bp/)

  • AvoidConditionalLogicInModules.md
  • AvoidStaticState.md
  • CyclicDependencies.md
  • DocumentPublicBindings.md
  • DontReuseAnnotations.md
  • InjectOnlyDirectDependencies.md
  • InjectingTheInjector.md
  • MinimizeMutability.md
  • ModulesShouldBeFastAndSideEffectFree.md
  • OrganizeModulesByFeature.md

チェックが付いてないものが手がついていないものです。取り掛かるときにコメントしてチェックをリクエストします。

翻訳手順

  • 1つ目のcommitはDeepLで自動翻訳
  • 2つ目以降のcommitでヒトが校正

参考 #10

追記:#13 で英語ページを/jaにコピーしてて、JavaのコードはPHPに書き直されています。

注意 英語をコピーしてそのままDeeplで翻訳すると英文の改行が含まれてて訳がおかしくなり直します。ウインドウサイズを横に伸ばしたりして確認して不要な改行を削除して、カット&ペーストでもう一度全文を翻訳すると良いです。

@koriym koriym added the ja label Feb 21, 2022
@koriym koriym added the good first issue Good for newcomers label Feb 23, 2022
This was referenced Feb 23, 2022
@komtaki
Copy link
Contributor

komtaki commented Feb 25, 2022

Bindingsを翻訳してみようと思います。:+1:

@77web
Copy link
Contributor

77web commented Feb 26, 2022

Injectionsやります!!

@gridhra
Copy link
Contributor

gridhra commented Feb 26, 2022

初めまして!

素敵なドキュメントだなと思ったのでcontributeさせてください
(新規issueを作るほどのことでもなさそうなのと、一応翻訳PJの範疇の内容だと判断しましたので、こちらに着手宣言いたします)

用件:
一点、英・日双方に共通する誤りを見つけたので共有、またPRを作成しておきます

問題:
PHPへと置換済みのコード例のなかに、classに対するアクセス修飾子が使用されている箇所があります
たぶん、Guiceドキュメントに書かれていたJavaコードの名残かなと思います

ex: Motivation/モチベーション中のコード

public class RealBillingService implements BillingServiceInterface

対応:
現時点で明確にphp化されていそうな箇所については、publicを外しておきます
まだjavaかもしれない箇所(コードブロックへの言語指示がまだjavaになっている箇所)はいったん対応から外しておこうかなと思います

P.S.:
(翻訳についても、未着手箇所のどれかからやろうと思っています)

@h13
Copy link
Contributor

h13 commented Feb 27, 2022

Guice にないところですが、 Graphing Applications やります。

@koriym
Copy link
Member Author

koriym commented Feb 27, 2022

@h13 ここです!https://github.com/google/guice/wiki/Grapher

@gridhra
Copy link
Contributor

gridhra commented Feb 27, 2022

Constructor Bindingsやります

  • 束縛方法の柔軟さを底上げしている機能である
  • Guiceドキュメントと比較して、PHP版独自の説明が追加されている

なことから面白そうだなと思ったので!

@koriym
Copy link
Member Author

koriym commented Feb 27, 2022

Constructor Bindingsはアノテーション/アトリビュートがつけれないサードパーティのコードのためで他の束縛と性格が違います。純粋なGuiceのDIからは離れてしまうのは申し訳ないところですが、どのように解決したかという視点で見てもらうと!

@koriym
Copy link
Member Author

koriym commented Feb 27, 2022

@orifuji また元々は日本語なのでこちらを見てもらうと
https://github.com/ray-di/Ray.Di/blob/2.13.3/README.ja.md#コンストラクタ束縛

@gridhra
Copy link
Contributor

gridhra commented Feb 27, 2022

@koriym
あ、なるほど! Ray.Di本体READMEからの逆輸入なんですね(英文Doc側ばかり見ていて気づきませんでした)

となると翻訳というよりほぼ移植になってしまうかもしれませんが、着手します!

@komtaki
Copy link
Contributor

komtaki commented Feb 27, 2022

Linked Bindingsをやります 👍

@gridhra
Copy link
Contributor

gridhra commented Feb 27, 2022

(Constructor Bindingsで頂いたレビューも踏まえつつ、)今度はNull Object Bindingsをやります!

@momospnr
Copy link
Contributor

@koriym
Instance Bindingsをやります!

@apple-x-co
Copy link
Contributor

apple-x-co commented May 17, 2022

@koriym bp/MinimizeMutability をやってみます🐣
#59

@koriym koriym linked a pull request May 19, 2022 that will close this issue
@apple-x-co
Copy link
Contributor

bp/InjectOnlyDirectDependencies をやります🐣

@koriym
Copy link
Member Author

koriym commented May 25, 2022

AvoidConditionalLogicInModulesやりました☀️

@koriym
Copy link
Member Author

koriym commented May 26, 2022

AvoidStaticStateやります。

@apple-x-co
Copy link
Contributor

bp/InjectingTheInjector をやります🐥

@koriym
Copy link
Member Author

koriym commented May 27, 2022

bp/DocumentPublicBindingsやります✋

@apple-x-co
Copy link
Contributor

bp/DontReuseAnnotations やります🐰

@apple-x-co
Copy link
Contributor

bp/OrganizeModulesByFeature やります🐞

@apple-x-co
Copy link
Contributor

bp/ModulesShouldBeFastAndSideEffectFree やります🐛

@koriym
Copy link
Member Author

koriym commented Jun 13, 2022

@apple-x-co コンプリートまでカウントダウンですね!

@apple-x-co
Copy link
Contributor

@apple-x-co コンプリートまでカウントダウンですね!

そうですね!!
このベストプラクティスは、本当に重要だも思っているので、完成間近で嬉しいです。
このページが終われば、既存ページは完了ですね。

あとは、用語の統一のために、全ページ見たほうが良い気もしてます。

@koriym
Copy link
Member Author

koriym commented Jun 13, 2022

  • 用語の統一
  • タイトル

いいですね。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
good first issue Good for newcomers ja
Projects
None yet
8 participants