From b93ea687573c85168ad4b658e19a003fe6763cec Mon Sep 17 00:00:00 2001 From: SATO Yusuke Date: Fri, 13 Sep 2019 14:17:20 +0900 Subject: [PATCH 1/8] Fix mistranslations MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Make all the translation of “in-line” to “インライン”, same as other paragraphs. - Translation of “reduce request times” is missing. - Fix mistranslation (the translation of “aggregation” should be "集約" rather than "集合" in this context.) - "別で処理する" ("process separately") is not contained in the original content. --- README-ja.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README-ja.md b/README-ja.md index 9aa683e2..a327f639 100644 --- a/README-ja.md +++ b/README-ja.md @@ -1280,7 +1280,7 @@ def set_user(user_id, values): Source: Intro to architecting systems for scale

-非同期のワークフローはもし、連続的に行われるとリクエスト時間を圧迫してしまうような重い処理を別で処理する手法です。また、定期的にデータを集合させるなどの時間がかかるような処理を前もって処理しておくことにも役立ちます。 +非同期のワークフローは、インラインで実行したらリクエスト時間を圧迫してしまうような重い処理の、リクエスト時間を短縮する手法です。また、定期的にデータを集約するといった時間のかかる処理を前もって処理しておくのにも役立ちます。 ### メッセージキュー From 55c32e4440968705c3a237c108418bdde7591238 Mon Sep 17 00:00:00 2001 From: SATO Yusuke Date: Fri, 13 Sep 2019 14:21:04 +0900 Subject: [PATCH 2/8] Fix mistranslations - Fix mistranslation (the original translation means "... processes it, and returns that signal when it completed.") - Make the translation more fluent. --- README-ja.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README-ja.md b/README-ja.md index a327f639..675a90f7 100644 --- a/README-ja.md +++ b/README-ja.md @@ -1286,8 +1286,8 @@ def set_user(user_id, values): メッセージキューはメッセージを受け取り、保存し、配信します。もし、処理がインラインで行うには遅すぎる場合、以下のようなワークフローでメッセージキューを用いるといいでしょう: -* アプリケーションはジョブをキューに配信し、ユーザーにジョブステータスを伝えます。 -* ワーカーがジョブキューから受け取って、処理を行い、終了したらそのシグナルを返します。 +* アプリケーションはジョブをキューに配信し、ユーザーにはジョブのステータスを伝えます。 +* ワーカーはジョブをキューから受け取って、処理を行い、ジョブが終了したらそのことをユーザへ通知します。 ユーザーの処理が止まることはなく、ジョブはバックグラウンドで処理されます。この間に、クライアントはオプションとして、タスクが完了したかのように見せるために小規模の処理を行います。例えば、ツイートを投稿するときに、ツイートはすぐにあなたのタイムラインに反映されたように見えますが、そのツイートが実際に全てのフォロワーに配信されるまでにはもう少し時間がかかっているでしょう。 From 9ae8cce4a6987aeb23f38f8502787f9172790022 Mon Sep 17 00:00:00 2001 From: SATO Yusuke Date: Fri, 13 Sep 2019 14:27:05 +0900 Subject: [PATCH 3/8] Fix mistranslations MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Fix translation ("optionally" cannot be literally translated into Japanese "オプション in this context.) - The translation of "might" is missing. - Make the translation more fluent. --- README-ja.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README-ja.md b/README-ja.md index 675a90f7..18067f60 100644 --- a/README-ja.md +++ b/README-ja.md @@ -1289,7 +1289,7 @@ def set_user(user_id, values): * アプリケーションはジョブをキューに配信し、ユーザーにはジョブのステータスを伝えます。 * ワーカーはジョブをキューから受け取って、処理を行い、ジョブが終了したらそのことをユーザへ通知します。 -ユーザーの処理が止まることはなく、ジョブはバックグラウンドで処理されます。この間に、クライアントはオプションとして、タスクが完了したかのように見せるために小規模の処理を行います。例えば、ツイートを投稿するときに、ツイートはすぐにあなたのタイムラインに反映されたように見えますが、そのツイートが実際に全てのフォロワーに配信されるまでにはもう少し時間がかかっているでしょう。 +ジョブはバックグラウンドで処理を行うため、ユーザの処理が止められることはありません。この際、タスクが完了したかのように見せるため、クライアント側でちょっとした処理を行ってもいいでしょう。例えば、ツイートを投稿したとき、あなたのタイムラインではそのツイートがすぐ反映されたように見えます。ですが、そのツイートが全てのフォロワーに実際に配信されるまでには、もう少し時間がかかっているかもしれません。 **Redis** はシンプルなメッセージ仲介としてはいいですが、メッセージが失われてしまう可能性があります。 From 6e7efb1e775c656ed2fb8abc628bdb554ea9a572 Mon Sep 17 00:00:00 2001 From: SATO Yusuke Date: Fri, 13 Sep 2019 14:28:43 +0900 Subject: [PATCH 4/8] Fix mistranslation MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - "メッセージ仲介" doesn’t make sense. --- README-ja.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README-ja.md b/README-ja.md index 18067f60..20bfed2b 100644 --- a/README-ja.md +++ b/README-ja.md @@ -1291,7 +1291,7 @@ def set_user(user_id, values): ジョブはバックグラウンドで処理を行うため、ユーザの処理が止められることはありません。この際、タスクが完了したかのように見せるため、クライアント側でちょっとした処理を行ってもいいでしょう。例えば、ツイートを投稿したとき、あなたのタイムラインではそのツイートがすぐ反映されたように見えます。ですが、そのツイートが全てのフォロワーに実際に配信されるまでには、もう少し時間がかかっているかもしれません。 -**Redis** はシンプルなメッセージ仲介としてはいいですが、メッセージが失われてしまう可能性があります。 +**Redis** はシンプルなメッセージブローカーとしては便利ですが、メッセージが失われてしまう可能性があります。 **RabbitMQ** はよく使われていますが、'AMQP'プロトコルに対応して、自前のノードを立てる必要があります。 From 5b3ee4a15c4ed33e08a85922ffff74694e93cec0 Mon Sep 17 00:00:00 2001 From: SATO Yusuke Date: Fri, 13 Sep 2019 14:29:45 +0900 Subject: [PATCH 5/8] Fix mistranslations - The translation of "manage" is missing. - Make the translation more fluent. --- README-ja.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README-ja.md b/README-ja.md index 20bfed2b..e529480c 100644 --- a/README-ja.md +++ b/README-ja.md @@ -1293,7 +1293,7 @@ def set_user(user_id, values): **Redis** はシンプルなメッセージブローカーとしては便利ですが、メッセージが失われてしまう可能性があります。 -**RabbitMQ** はよく使われていますが、'AMQP'プロトコルに対応して、自前のノードを立てる必要があります。 +**RabbitMQ** はよく使われていますが、'AMQP'プロトコルを使う必要があります。また、自前でノードを管理する必要があります。 **Amazon SQS** という選択肢もありますが、レイテンシーが高く、メッセージが重複して配信されてしまう可能性があります。 From afed66f3a3e02099cfd216797a05b6520eeb6423 Mon Sep 17 00:00:00 2001 From: SATO Yusuke Date: Fri, 13 Sep 2019 14:30:39 +0900 Subject: [PATCH 6/8] Fix mistranslations - The translation of "hosted" is missing. - Make the translation more fluent. --- README-ja.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README-ja.md b/README-ja.md index e529480c..5d0f7bf7 100644 --- a/README-ja.md +++ b/README-ja.md @@ -1295,7 +1295,7 @@ def set_user(user_id, values): **RabbitMQ** はよく使われていますが、'AMQP'プロトコルを使う必要があります。また、自前でノードを管理する必要があります。 -**Amazon SQS** という選択肢もありますが、レイテンシーが高く、メッセージが重複して配信されてしまう可能性があります。 +**Amazon SQS** はホスティングされていますが、遅延が大きく、またメッセージが重複して配信されてしまう可能性があります。 ### タスクキュー From e0959b3abf13d7a4b915ad519ada65cc0196074e Mon Sep 17 00:00:00 2001 From: SATO Yusuke Date: Fri, 13 Sep 2019 14:33:44 +0900 Subject: [PATCH 7/8] Fix mistranslations. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - "スケジュール管理" ("schedule management") is mistranslation of "support scheduling". - "計算集約的" is commonly used for the translation for "computationally-intensive". --- README-ja.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README-ja.md b/README-ja.md index 5d0f7bf7..3befebea 100644 --- a/README-ja.md +++ b/README-ja.md @@ -1299,7 +1299,7 @@ def set_user(user_id, values): ### タスクキュー -タスクキューはタスクとその関連するデータを受け取り、処理した上でその結果を返します。スケジュール管理をできるほか、バックグラウンドでとても重いジョブをこなすこともできます。 +タスクキューはタスクとその関連するデータを受け取り、処理した上でその結果を返します。スケジューリングもできますし、バックグラウンドでとても計算量集約的なジョブをこなすのにも使えます。 **Celery** はスケジューリングとpythonのサポートがあります。 From 077643082e735eb149dd7e1cb224e6510838014e Mon Sep 17 00:00:00 2001 From: SATO Yusuke Date: Fri, 13 Sep 2019 14:36:33 +0900 Subject: [PATCH 8/8] Fix mistranslations - Fix mistranslation (the original translation means "Back pressure can be avoided by limiting queue size") - Fix mistranslation (the original translation means "... and reducing response times for jobs already in the queue.") - Make the translation more fluent. --- README-ja.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README-ja.md b/README-ja.md index 3befebea..8fcdaef9 100644 --- a/README-ja.md +++ b/README-ja.md @@ -1299,13 +1299,13 @@ def set_user(user_id, values): ### タスクキュー -タスクキューはタスクとその関連するデータを受け取り、処理した上でその結果を返します。スケジューリングもできますし、バックグラウンドでとても計算量集約的なジョブをこなすのにも使えます。 +タスクキューはタスクとその関連するデータを受け取り、処理した上でその結果を返します。スケジューリングもできますし、バックグラウンドで計算集約的なジョブをこなすのにも使えます。 **Celery** はスケジューリングとpythonのサポートがあります。 ### バックプレッシャー -もし、キューが拡大しすぎると、メモリーよりもキューの方が大きくなりキャッシュミスが起こり、ディスク読み出しにつながり、パフォーマンスが低下することにつながります。[バックプレッシャー](http://mechanical-sympathy.blogspot.com/2012/05/apply-back-pressure-when-overloaded.html)はキューサイズを制限することで回避することができ、高いスループットを確保しキューにすでにあるジョブについてのレスポンス時間を短縮できます。キューがいっぱいになると、クライアントはサーバービジーもしくはHTTP 503をレスポンスとして受け取りまた後で時間をおいてアクセスするようにメッセージを受け取ります。クライアントは[exponential backoff](https://en.wikipedia.org/wiki/Exponential_backoff)などによって後ほど再度時間を置いてリクエストすることができます。 +もし、キューが拡大しすぎると、メモリーよりもキューの方が大きくなりキャッシュミスが起こり、ディスク読み出しにつながり、パフォーマンスが低下することにつながります。[バックプレッシャー](http://mechanical-sympathy.blogspot.com/2012/05/apply-back-pressure-when-overloaded.html)によりキューサイズを制限することで、高スループットと、キューに入っているジョブの応答時間の両方を良好に保つことができます。キューがいっぱいになると、クライアントはサーバービジーもしくはHTTP 503をレスポンスとして受け取りまた後で時間をおいてアクセスするようにメッセージを受け取ります。クライアントは[exponential backoff](https://en.wikipedia.org/wiki/Exponential_backoff)などによって後ほど再度時間を置いてリクエストすることができます。 ### 欠点: 非同期処理