Added autotranslated and cleanup english documentation #1654

Martin-Lierschof · 2021-12-23T07:27:01Z

Automatic translated missing Chinese documents and added them to the english version.

serverglen

There are two documents that are not translated

serverglen · 2021-12-23T13:30:02Z

docs/en/flags.md

@@ -0,0 +1,137 @@
+brpc使用gflags管理配置。如果你的程序也使用gflags，那么你应该已经可以修改和brpc相关的flags，你可以浏览[flags服务](http://brpc.baidu.com:8765/flags)了解每个flag的具体功能。如果你的程序还没有使用gflags，我们建议你使用，原因如下：


This document is not translated

serverglen · 2021-12-23T13:30:36Z

docs/en/nshead_service.md

@@ -0,0 +1,230 @@
+ub是百度内广泛使用的老RPC框架，在迁移ub服务时不可避免地需要[访问ub-server](ub_client.md)或被ub-client访问。ub使用的协议种类很多，但都以nshead作为二进制包的头部，这类服务在brpc中统称为**“nshead service”**。


This document is not translated

Martin-Lierschof · 2021-12-23T14:04:32Z

Thanks for the review, done!

zyearn · 2021-12-23T20:17:14Z

Hi Martin,

Thanks for the translation work. Since it's auto-translation, we need to check it manually and make sure there is no misunderstanding in English version.

Could you please also read through the files and update them(or just comment) if they don't look natural to you?

Jiashun

wwbmmm · 2021-12-24T02:58:33Z

Maybe we can add a notice at the beginning of the document, stating that this document is automatically translated?

Martin-Lierschof · 2021-12-27T06:43:49Z

I did read them thru mostly and corrected a few major mistakes. Right now its the best i can do with my limited time. I could as @wwbmmm stated and add a notification that to the texts which are autotranslated.

zyearn · 2021-12-30T11:19:52Z

@Martin-Lierschof Ah I see. Adding a notice at the beginning would be great.

zyearn · 2021-12-30T11:21:11Z

docs/en/auto_concurrency_limiter.md

@@ -0,0 +1,153 @@
+# Adaptive current limit


There're some specific translation that auto-translation cannot catch.

we should replace 'current limit' with Adaptive Load Shedding

zyearn · 2021-12-30T11:22:51Z

docs/en/auto_concurrency_limiter.md

+
+In this way, when a node returns to overload, the client can initiate a retry to other nodes, so as not to lose traffic as much as possible.
+
+## How to open


How to turn on?

zyearn · 2021-12-30T11:27:18Z

docs/en/auto_concurrency_limiter.md

+
+## Principle
+
+### noun


Definitions / Terms ?

zyearn · 2021-12-30T11:28:05Z

docs/en/baidu_std.md

@@ -0,0 +1,159 @@
+# introduce


Introduction

zyearn · 2021-12-30T11:29:21Z

docs/en/baidu_std.md

+
+The parameters needed to call the method should be placed in a Protobuf message. If the method returns a result, it should also be placed in a Protobuf message. The specific definition shall be agreed upon by the communicating parties. In particular, an empty Protobuf message can be used to indicate that the request/response is empty.
+
+## Bag


zyearn · 2021-12-30T11:32:09Z

docs/en/case_baidu_dsp.md

@@ -0,0 +1,23 @@
+# background


zyearn · 2021-12-30T11:33:06Z

docs/en/case_elf.md

+
+ELF (Essential/Extreme/Excellent Learning Framework) framework provides learning/mining algorithm development support for big data applications inside and outside the company. The platform mainly includes framework support for iterative data processing, communication support during parallel computing, and a distributed, fast, and highly available parameter server for storing large-scale parameters. Used in fcr-model, public cloud bml, big data laboratory, voice technology department, etc. Previously it was based on the rpc packaged by [zeromq](http://zeromq.org/), this time I use brpc instead.
+
+# in conclusion


Maybe we should replace all 'in conclusion' in heading with 'Summary'?

zyearn · 2021-12-30T11:33:30Z

docs/en/circuit_breaker.md

+# Optional fusing strategy
+Relying only on the above-mentioned default circuit breaker strategy sometimes cannot fully meet the demand. Take an extreme example: if a downstream node logic thread is all stuck, but the io thread can work normally, then all requests will time out, but the tcp connection Can be established normally. For such situations, brpc provides a more radical fusing strategy on the basis of the default fusing strategy. After being turned on, brpc will determine whether the node is in a fault state based on the error rate.
+
+## How to open


zyearn · 2021-12-30T11:36:39Z

docs/en/contention_profiler.md

@@ -0,0 +1,31 @@
+brpc can analyze the time spent waiting for the lock and the functions that waited for.
+
+# How to open


And we may need replace 'open' with 'turn on' in all places

zyearn · 2021-12-30T11:38:56Z

docs/en/timer_keeping.md

@@ -0,0 +1,55 @@
+Doing something at a few points is a basic requirement of the RPC framework, which is harder than it looks.


at some certain time points

zyearn · 2021-12-30T11:40:47Z

@Martin-Lierschof Hi, I skimmed through the translation and found something confusing that auto-translation didn't catch. Could you take another look?

zyearn · 2021-12-30T11:44:23Z

docs/en/circuit_breaker.md

@@ -0,0 +1,64 @@
+# Fuse function


I'm not sure if people can understand what fuse means here

Added autotranslated and cleanup english documentation

bd9babb

serverglen reviewed Dec 23, 2021

View reviewed changes

Autotranslated missing files.

3d12418

zyearn requested changes Dec 30, 2021

View reviewed changes

zyearn reviewed Dec 30, 2021

View reviewed changes

docs/en/circuit_breaker.md

@@ -0,0 +1,64 @@

# Fuse function

Copy link

Member

zyearn Dec 30, 2021

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure if people can understand what fuse means here

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Added autotranslated and cleanup english documentation #1654

Added autotranslated and cleanup english documentation #1654

Martin-Lierschof commented Dec 23, 2021

serverglen left a comment

serverglen Dec 23, 2021

serverglen Dec 23, 2021

Martin-Lierschof commented Dec 23, 2021

zyearn commented Dec 23, 2021

wwbmmm commented Dec 24, 2021

Martin-Lierschof commented Dec 27, 2021

zyearn commented Dec 30, 2021

zyearn Dec 30, 2021

zyearn Dec 30, 2021

zyearn Dec 30, 2021

zyearn Dec 30, 2021

zyearn Dec 30, 2021

zyearn Dec 30, 2021

zyearn Dec 30, 2021

zyearn Dec 30, 2021

zyearn Dec 30, 2021

zyearn Dec 30, 2021

zyearn commented Dec 30, 2021

zyearn Dec 30, 2021

		@@ -0,0 +1,137 @@
		brpc使用gflags管理配置。如果你的程序也使用gflags，那么你应该已经可以修改和brpc相关的flags，你可以浏览[flags服务](http://brpc.baidu.com:8765/flags)了解每个flag的具体功能。如果你的程序还没有使用gflags，我们建议你使用，原因如下：

		@@ -0,0 +1,230 @@
		ub是百度内广泛使用的老RPC框架，在迁移ub服务时不可避免地需要[访问ub-server](ub_client.md)或被ub-client访问。ub使用的协议种类很多，但都以nshead作为二进制包的头部，这类服务在brpc中统称为“nshead service”。


		In this way, when a node returns to overload, the client can initiate a retry to other nodes, so as not to lose traffic as much as possible.

		## How to open


		The parameters needed to call the method should be placed in a Protobuf message. If the method returns a result, it should also be placed in a Protobuf message. The specific definition shall be agreed upon by the communicating parties. In particular, an empty Protobuf message can be used to indicate that the request/response is empty.

		## Bag


		ELF (Essential/Extreme/Excellent Learning Framework) framework provides learning/mining algorithm development support for big data applications inside and outside the company. The platform mainly includes framework support for iterative data processing, communication support during parallel computing, and a distributed, fast, and highly available parameter server for storing large-scale parameters. Used in fcr-model, public cloud bml, big data laboratory, voice technology department, etc. Previously it was based on the rpc packaged by [zeromq](http://zeromq.org/), this time I use brpc instead.

		# in conclusion

		@@ -0,0 +1,31 @@
		brpc can analyze the time spent waiting for the lock and the functions that waited for.

		# How to open

		@@ -0,0 +1,55 @@
		Doing something at a few points is a basic requirement of the RPC framework, which is harder than it looks.

Added autotranslated and cleanup english documentation #1654

Are you sure you want to change the base?

Added autotranslated and cleanup english documentation #1654

Conversation

Martin-Lierschof commented Dec 23, 2021

serverglen left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Martin-Lierschof commented Dec 23, 2021

zyearn commented Dec 23, 2021

wwbmmm commented Dec 24, 2021

Martin-Lierschof commented Dec 27, 2021

zyearn commented Dec 30, 2021

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

zyearn commented Dec 30, 2021

Choose a reason for hiding this comment