Web-Dev-For-Beginners
2022-06-09
| _ | Original | Translated |
|---|---|---|
| Recent Commit | c285daba3f32d11c5e431cbfb44fbd64c434433d | 9df992e7ba65ae404ed821cd04895df38ca05582 |
| Updated | 2022-06-08 16:56:58 -0700 | 2022-05-22 14:31:30 +0900 |
| Number of Files | 460 | 138 |
| Link | link | link |
-
CODE_OF_CONDUCT.md : File Deleted
-
CONTRIBUTING.md : File Modified +3 / -30 ๐ 445
โ line 1
โ None
โ (๊ธฐ์ฌํ๊ธฐ)
=> sentence distance : None
โ line 3
โ None
โ ๋ณธ ์ ์ฅ์๋ [Microsoft Open Source Code of Conduct(Microsoft ์คํ ์์ค ๊ท์ )](https://opensource.microsoft.com/codeofconduct/)๋ฅผ ์ค์ํฉ๋๋ค.
=> sentence distance : None
โ line 4
โ None
โ ์์ธํ ๋ด์ฉ์ [์ค์ ์ฌํญ FAQ(์๋ฌธ)](https://opensource.microsoft.com/codeofconduct/faq/)๋ฅผ ์ฐธ์กฐํ์ธ์.
=> sentence distance : None
โ line 5
โ None
โ ๋๋ opencode@microsoft.com์ ๊ถ๊ธํ ์ฌํญ์ ๋ฌธ์ํ๊ฑฐ๋ ์๊ฒฌ์ ์ ์ํ์ค ์ ์์ต๋๋ค.
=> sentence distance : None
โ line 11
โ Blog Contributions
โ Korean
=> sentence distance : 15
โ line 22
โ azure-sdk/main.
โ azure-sdk-korean/main.
=> sentence distance : 7
3 words added. 30 words deleted.
Added words rate 0.6741573033707865% (3 / 445 words)
Deleted words rate 6.741573033707865% (30 / 445 words)
-
README.md : File Modified +193 / -131 ๐ 519
โ line 1
โ None
โ Documentation for Korean
=> sentence distance : None
โ line 3
โ The Azure SDK delivers a platform for developers to leverage the wide variety of Azure services in their language of choice. The source for the client libraries exists for the most part in repositories for each language. This repository is meant to be a jumping off point into those language specific repositories. Issues related to a specific language should be opened in the corresponding repository but cross cutting issues can be opened in this repository.
โ (For English, please visit https://github.com/Azure/azure-sdk repository)
=> sentence distance : 410
โ line 5
โ Language
โ Azure SDK๋ ๊ฐ๋ฐ์๊ฐ ๋ค์ํ Azure ์๋น์ค๋ฅผ ์ํ๋ ํ๋ก๊ทธ๋๋ฐ ์ธ์ด๋ก ํ์ฉํ ์ ์๋ ํ๋ซํผ์ ์ ๊ณตํ๊ณ ์์ต๋๋ค. ๊ฐ ์ธ์ด์ ๋ํ ์์ค ์ ์ฅ์์ ํด๋น ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ๋ํ ์์ค ์ฝ๋๊ฐ ์์ต๋๋ค. ์ด ์ ์ฅ์๋ ํด๋น ํ๋ก๊ทธ๋๋ฐ ์ธ์ด ๋ณ ์ ์ฅ์๋ฅผ ๊ฐ๋ฆฌํค๋ฉฐ, ํ๊ธ๋ก ๋ณด๋ค ์์ธํ ์ค๋ช ์ ๊ณต์ ํ๊ณ ์ ํฉ๋๋ค. ๊ตฌ์ฒด์ ์ธ ์ด์๋ ๊ฐ SDK ์ ์ฅ์๋ฅผ ํตํด ํ์ธํ์ค ์ ์์ต๋๋ค.-]| [-์ธ์ด
=> sentence distance : 219
โ line 5
โ Design Guidelines
โ ๋์์ธ ๊ฐ์ด๋๋ผ์ธ (์๋ฌธ)
=> sentence distance : 16
โ line 5
โ Packages
โ ํจํค์ง
=> sentence distance : 8
โ line 5
โ Repo
โ ์ ์ฅ์
=> sentence distance : 4
โ line 5
โ Documentation
โ ๋ฌธ์ (์๋ฌธ)
=> sentence distance : 13
โ line 5
โ None
โ Azure SDK๋ ๊ฐ๋ฐ์๊ฐ ๋ค์ํ Azure ์๋น์ค๋ฅผ ์ํ๋ ํ๋ก๊ทธ๋๋ฐ ์ธ์ด๋ก ํ์ฉํ ์ ์๋ ํ๋ซํผ์ ์ ๊ณตํ๊ณ ์์ต๋๋ค. ๊ฐ ์ธ์ด์ ๋ํ ์์ค ์ ์ฅ์์ ํด๋น ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ๋ํ ์์ค ์ฝ๋๊ฐ ์์ต๋๋ค. ์ด ์ ์ฅ์๋ ํด๋น ํ๋ก๊ทธ๋๋ฐ ์ธ์ด ๋ณ ์ ์ฅ์๋ฅผ ๊ฐ๋ฆฌํค๋ฉฐ, ํ๊ธ๋ก ๋ณด๋ค ์์ธํ ์ค๋ช ์ ๊ณต์ ํ๊ณ ์ ํฉ๋๋ค. ๊ตฌ์ฒด์ ์ธ ์ด์๋ ๊ฐ SDK ์ ์ฅ์๋ฅผ ํตํด ํ์ธํ์ค ์ ์์ต๋๋ค.
=> sentence distance : None
โ line 18
โ Service teams should schedule reviews of their client libraries with the Azure SDK Architecture Board. See the [Review Process][revproc] for more information.
โ # ๊ธฐ์ฌํ๊ธฐ (Contributing)
=> sentence distance : 148
โ line 24
โ - **Client Library**. This refers to a library (and associated tools, documentation, and samples) that customers/developers use to ease working with an Azure service. There is often one client library per service and per programming language. Sometimes a single client library will contain the ability to connect to multiple services. Each client library is published separately to the appropriate language-specific package repository. These releases are performed exclusively by the Azure SDK engineering systems team. Customers/Developers consume and use each client library separately as necessary to solve their use case.
โ ๋ณธ ์ ์ฅ์๋ Microsoft ์คํ ์์ค์ ๊ธฐ์ฌํ๊ธฐ ์ํ ๊ฐ์ด๋๋ผ์ธ์ ๋ฐ๋ฅด๊ณ ์์ต๋๋ค.
=> sentence distance : 608
โ line 86
โ [JavaScript
โ [Javascript
=> sentence distance : 1
193 words added. 131 words deleted.
Added words rate 37.1868978805395% (193 / 519 words)
Deleted words rate 25.240847784200387% (131 / 519 words)
-
SECURITY.md : File Modified +3 / -3 ๐ 334
โ line 7
โ vulnerability](https://docs.microsoft.com/previous-versions/tn-archive/cc751383(v=technet.10)),
โ vulnerability](https://docs.microsoft.com/en-us/previous-versions/tn-archive/cc751383(v=technet.10)),
=> sentence distance : 6
โ line 15
โ page](https://www.microsoft.com/msrc/pgp-key-msrc).
โ page](https://www.microsoft.com/en-us/msrc/pgp-key-msrc).
=> sentence distance : 6
โ line 39
โ Disclosure](https://www.microsoft.com/msrc/cvd).
โ Disclosure](https://www.microsoft.com/en-us/msrc/cvd).
=> sentence distance : 6
3 words added. 3 words deleted.
Added words rate 0.8982035928143712% (3 / 334 words)
Deleted words rate 0.8982035928143712% (3 / 334 words)
-
SUPPORT.md : File Deleted
-
_includes
-
info
-
header.md : File Deleted
-
-
refs.md : File Modified +0 / -0 ๐ 118
0 words added. 0 words deleted.
Added words rate 0.0% (0 / 118 words)
Deleted words rate 0.0% (0 / 118 words)
-
releases
-
android.md : File Modified +10 / -0 ๐ 28
โ line 5
โ if include.type == "all" %}
โ None
=> sentence distance : None
โ line 8
โ | where: 'Support', 'deprecated' %}
โ None
=> sentence distance : None
10 words added. 0 words deleted.
Added words rate 35.714285714285715% (10 / 28 words)
Deleted words rate 0.0% (0 / 28 words)
-
c.md : File Modified +11 / -0 ๐ 29
โ line 1
โ type=include.type
โ None
=> sentence distance : None
โ line 5
โ if include.type == "all" %}
โ None
=> sentence distance : None
โ line 8
โ | where: 'Support', 'deprecated' %}
โ None
=> sentence distance : None
11 words added. 0 words deleted.
Added words rate 37.93103448275862% (11 / 29 words)
Deleted words rate 0.0% (0 / 29 words)
-
cpp.md : File Modified +11 / -0 ๐ 28
โ line 1
โ type=include.type
โ None
=> sentence distance : None
โ line 5
โ if include.type == "all" %}
โ None
=> sentence distance : None
โ line 8
โ | where: 'Support', 'deprecated' %}
โ None
=> sentence distance : None
11 words added. 0 words deleted.
Added words rate 39.285714285714285% (11 / 28 words)
Deleted words rate 0.0% (0 / 28 words)
-
dotnet.md : File Modified +1 / -0 ๐ 60
โ line 1
โ type=include.type
โ None
=> sentence distance : None
1 words added. 0 words deleted.
Added words rate 1.6666666666666667% (1 / 60 words)
Deleted words rate 0.0% (0 / 60 words)
-
go.md : File Modified +1 / -0 ๐ 60
โ line 1
โ type=include.type
โ None
=> sentence distance : None
1 words added. 0 words deleted.
Added words rate 1.6666666666666667% (1 / 60 words)
Deleted words rate 0.0% (0 / 60 words)
-
header.md : File Modified +16 / -22 ๐ 77
โ line 6
โ provides an inventory
โ contains links to all
=> sentence distance : 17
โ line 6
โ all
โ the
=> sentence distance : 3
โ line 6
โ **Client Libraries**
โ "Client
=> sentence distance : 14
โ line 6
โ **Management Libraries**
โ Management Libraries"
=> sentence distance : 4
โ line 6
โ guidelines](https://aka.ms/azsdk/guide).
โ Guidelines](https://aka.ms/azsdk/guide).
=> sentence distance : 1
โ line 6
โ **All**
โ "All"
=> sentence distance : 4
โ line 6
โ don't
โ also-] contains {+the aforementioned+} libraries {+and those+} that [-do not yet
=> sentence distance : 76
โ line 6
โ the aforementioned
โ None
=> sentence distance : None
โ line 6
โ and those
โ None
=> sentence distance : None
โ line 6
โ None
โ also
=> sentence distance : None
โ line 30
โ <img
โ None
=> sentence distance : None
16 words added. 22 words deleted.
Added words rate 20.77922077922078% (16 / 77 words)
Deleted words rate 28.57142857142857% (22 / 77 words)
-
ios.md : File Modified +11 / -0 ๐ 28
โ line 1
โ type=include.type
โ None
=> sentence distance : None
โ line 5
โ if include.type == "all" %}
โ None
=> sentence distance : None
โ line 8
โ | where: 'Support', 'deprecated' %}
โ None
=> sentence distance : None
11 words added. 0 words deleted.
Added words rate 39.285714285714285% (11 / 28 words)
Deleted words rate 0.0% (0 / 28 words)
-
java.md : File Modified +1 / -0 ๐ 60
โ line 1
โ type=include.type
โ None
=> sentence distance : None
1 words added. 0 words deleted.
Added words rate 1.6666666666666667% (1 / 60 words)
Deleted words rate 0.0% (0 / 60 words)
-
js.md : File Modified +1 / -0 ๐ 60
โ line 1
โ type=include.type
โ None
=> sentence distance : None
1 words added. 0 words deleted.
Added words rate 1.6666666666666667% (1 / 60 words)
Deleted words rate 0.0% (0 / 60 words)
-
languages.md : File Modified +9 / -9 ๐ 45
โ line 1
โ type=include.type
โ type="client"
=> sentence distance : 8
โ line 2
โ type=include.type
โ type="client"
=> sentence distance : 8
โ line 3
โ type=include.type
โ type="client"
=> sentence distance : 8
โ line 4
โ type=include.type
โ type="client"
=> sentence distance : 8
โ line 5
โ type=include.type
โ type="client"
=> sentence distance : 8
โ line 6
โ type=include.type
โ type="client"
=> sentence distance : 8
โ line 7
โ type=include.type
โ type="client"
=> sentence distance : 8
โ line 8
โ type=include.type
โ type="client"
=> sentence distance : 8
โ line 9
โ type=include.type
โ type="client"
=> sentence distance : 8
9 words added. 9 words deleted.
Added words rate 20.0% (9 / 45 words)
Deleted words rate 20.0% (9 / 45 words)
-
links.md : File Modified +9 / -0 ๐ 290
โ line 52
โ if item.Support == "deprecated" and item.DeprecatedDate != "" %}
โ None
=> sentence distance : None
9 words added. 0 words deleted.
Added words rate 3.103448275862069% (9 / 290 words)
Deleted words rate 0.0% (0 / 290 words)
-
nav.md : File Modified +0 / -0 ๐ 31
0 words added. 0 words deleted.
Added words rate 0.0% (0 / 31 words)
Deleted words rate 0.0% (0 / 31 words)
-
notes
-
go.md : File Added ๐ 182
182 words added.
-
-
pkgbadge.md : File Modified +10 / -1 ๐ 60
โ line 2
โ target="_blank"
โ None
=> sentence distance : None
โ line 5
โ >{% if item.Support == 'deprecated' %}<= {% endif %}{{
โ >{{
=> sentence distance : 54
10 words added. 1 words deleted.
Added words rate 16.666666666666664% (10 / 60 words)
Deleted words rate 1.6666666666666667% (1 / 60 words)
-
pkgrow.md : File Modified +35 / -5 ๐ 83
โ line 3
โ
โ None
=> sentence distance : None
โ line 4
โ prepend: "^" %}
โ remove:
=> sentence distance : 12
โ line 5
โ | prepend: "^" %}
โ None
=> sentence distance : None
โ line 13
โ {% endif %}
โ None
=> sentence distance : None
โ line 17
โ{{
โ{{
=> sentence distance : 8
โ line 17
โ None
โ %}(New){%endif%}
=> sentence distance : None
โ line 18
โ %}(New){%endif%}
โ{{item.Package}}
=> sentence distance : 56
โ line 22
โ {% if include.type != "deprecated" %}
โ None
=> sentence distance : None
โ line 26
โ {% else %}
โ None
=> sentence distance : None
35 words added. 5 words deleted.
Added words rate 42.168674698795186% (35 / 83 words)
Deleted words rate 6.024096385542169% (5 / 83 words)
-
pkgtable.md : File Modified +0 / -0 ๐ 38
0 words added. 0 words deleted.
Added words rate 0.0% (0 / 38 words)
Deleted words rate 0.0% (0 / 38 words)
-
python.md : File Modified +0 / -0 ๐ 60
0 words added. 0 words deleted.
Added words rate 0.0% (0 / 60 words)
Deleted words rate 0.0% (0 / 60 words)
-
replace.md : File Modified +6 / -1 ๐ 69
โ line 12
โ {% if item.ReplaceGuide != "" %}
โ </small></div>
=> sentence distance : 29
6 words added. 1 words deleted.
Added words rate 8.695652173913043% (6 / 69 words)
Deleted words rate 1.4492753623188406% (1 / 69 words)
-
tabs.md : File Modified +0 / -0 ๐ 60
0 words added. 0 words deleted.
Added words rate 0.0% (0 / 60 words)
Deleted words rate 0.0% (0 / 60 words)
-
variables
-
cpp.md : File Modified +21 / -2 ๐ 36
โ line 4
โ
โ
โ %}-->
=> sentence distance : 1
21 words added. 2 words deleted.
Added words rate 58.333333333333336% (21 / 36 words)
Deleted words rate 5.555555555555555% (2 / 36 words)
-
-
-
tables
-
data_namespaces.md : File Modified +84 / -77 ๐ 156
โ line 1
โ Namespace Group
โ ๋ค์์คํ์ด์ค ๊ทธ๋ฃน
=> sentence distance : 14
โ line 1
โ Functional Area
โ ๊ธฐ๋ฅ ์์ญ
=> sentence distance : 14
โ line 3
โ Artificial intelligence, including machine learning
โ ์ธ๊ณต์ง๋ฅ, ๊ธฐ๊ณ ํ์ต์ ํฌํจ
=> sentence distance : 47
โ line 4
โ Gathering data for metrics or usage
โ ๋ฉํธ๋ฆญ ๋๋ ์ฌ์ฉ๋์ ๋ํ ๋ฐ์ดํฐ ์์ง
=> sentence distance : 31
โ line 5
โ Services related to containers
โ ์ปจํ ์ด๋ ๊ด๋ จ ์๋น์ค
=> sentence distance : 28
โ line 6
โ Communication services
โ ์ปค๋ฎค๋์ผ์ด์ ์๋น์ค
=> sentence distance : 21
โ line 7
โ Dealing with structured data stores like databases
โ ๋ฐ์ดํฐ๋ฒ ์ด์ค์ ๊ฐ์ ์ ํ ๋ฐ์ดํฐ ์ ์ฅ์ ์ฒ๋ฆฌ
=> sentence distance : 45
โ line 8
โ Gathering data for diagnosing issues
โ ๋ฌธ์ ์ง๋จ์ ์ํ ๋ฐ์ดํฐ ์์ง
=> sentence distance : 32
โ line 9
โ Digital Twins, digital representations of physical spaces and
โ ๋์งํธ ํธ์(Digital Twins), ๋ฌผ๋ฆฌ์ ๊ณต๊ฐ ๋ฐ
=> sentence distance : 47
โ line 9
โ devices
โ ์ฅ์น์ ๋์งํธ ํํ
=> sentence distance : 10
โ line 10
โ Authentication and authorization
โ ์ธ์ฆ ๋ฐ ๊ถํ ๋ถ์ฌ
=> sentence distance : 30
โ line 11
โ Internet of things
โ ์ฌ๋ฌผ ์ธํฐ๋ท
=> sentence distance : 17
โ line 12
โ Control Plane
โ ์ปจํธ๋กค ํ๋ ์ธ
=> sentence distance : 12
โ line 12
โ Resource Manager)
โ ๋ฆฌ์์ค ๊ด๋ฆฌ์)
=> sentence distance : 15
โ line 13
โ Audio and video technologies
โ ์ค๋์ค ๋ฐ ๋น๋์ค ๊ธฐ์
=> sentence distance : 25
โ line 14
โ Messaging services, like push notifications or pub-sub
โ ํธ์ ์๋ฆผ ๋๋ pub-sub๊ณผ ๊ฐ์ ๋ฉ์์ง ์๋น์ค
=> sentence distance : 47
โ line 15
โ Mixed reality technologies
โ ํผํฉ ํ์ค ๊ธฐ์
=> sentence distance : 24
โ line 16
โ Monitor
โ Monitor์์ ์ ๊ณตํ๋ ์๋น์ค
=> sentence distance : 11
โ line 16
โ Services that are offered by
โ None
=> sentence distance : None
โ line 17
โ Quantum computing technologies
โ ํํ ์ปดํจํ ๊ธฐ์
=> sentence distance : 28
โ line 18
โ Search technologies
โ ๊ฒ์ ๊ธฐ์
=> sentence distance : 18
โ line 19
โ Security and cryptography
โ ๋ณด์ ๋ฐ ์ํธํ
=> sentence distance : 23
โ line 20
โ Storage of unstructured data
โ ๋น์ ํ ๋ฐ์ดํฐ ์ ์ฅ์
=> sentence distance : 26
84 words added. 77 words deleted.
Added words rate 53.84615384615385% (84 / 156 words)
Deleted words rate 49.358974358974365% (77 / 156 words)
-
environment_variables.md : File Modified +64 / -69 ๐ 183
โ line 1
โ Environment Variable
โ ํ๊ฒฝ ๋ณ์
=> sentence distance : 19
โ line 1
โ Purpose
โ ๋ชฉ์
=> sentence distance : 7
โ line 3
โ **Proxy Settings**
โ **ํ๋ก์ ์ค์ **
=> sentence distance : 13
โ line 4
โ connections
โ ์ฐ๊ฒฐ์ ์ํ ํ๋ก์
=> sentence distance : 11
โ line 4
โ Proxy for
โ None
=> sentence distance : None
โ line 5
โ connections
โ ์ฐ๊ฒฐ์ ์ํ ํ๋ก์
=> sentence distance : 11
โ line 5
โ Proxy for
โ None
=> sentence distance : None
โ line 6
โ Hosts which must not use a proxy
โ ํ๋ก์๋ฅผ ์ฌ์ฉํ๋ฉด ์ ๋๋ ํธ์คํธ
=> sentence distance : 28
โ line 7
โ Proxy for
โ HTTP_PROXY ๊ทธ๋ฆฌ๊ณ /๋๋ HTTPS_PROXY๊ฐ ์ ์๋์ง ์์ ๊ฒฝ์ฐ
=> sentence distance : 39
โ line 7
โ and/or
โ ๊ทธ๋ฆฌ๊ณ /๋๋
=> sentence distance : 5
โ line 7
โ connections in case HTTP_PROXY and/or HTTPS_PROXY are not defined
โ ์ฐ๊ฒฐ์ ์ํ ํ๋ก์
=> sentence distance : 63
โ line 8
โ **Identity**
โ **ID**
=> sentence distance : 7
โ line 9
โ Credentials
โ ์๊ฒฉ ์ฆ๋ช
=> sentence distance : 11
โ line 10
โ Credentials
โ ์๊ฒฉ ์ฆ๋ช
=> sentence distance : 11
โ line 11
โ username for U/P Auth
โ U/P ์ธ์ฆ์ ์ํ-] Azure [-์ฌ์ฉ์ ์ด๋ฆ
=> sentence distance : 24
โ line 11
โ None
โ U/P ์ธ์ฆ์ ์ํ
=> sentence distance : None
โ line 12
โ password for U/P Auth
โ U/P ์ธ์ฆ์ ์ํ-] Azure [-๋น๋ฐ ๋ฒํธ
=> sentence distance : 24
โ line 12
โ None
โ U/P ์ธ์ฆ์ ์ํ
=> sentence distance : None
โ line 18
โ **Pipeline Configuration**
โ **ํ์ดํ๋ผ์ธ ๊ตฌ์ฑ**
=> sentence distance : 21
โ line 19
โ Disables telemetry
โ ์๊ฒฉ ๋ถ์ ๋นํ์ฑํ
=> sentence distance : 17
โ line 20
โ Enable logging by setting a log level.
โ ๋ก๊ทธ ๋ ๋ฒจ์ ์ค์ ํ์ฌ ๋ก๊น ํ์ฑํ
=> sentence distance : 34
โ line 21
โ Disables tracing
โ ์ถ์ ๋นํ์ฑํ
=> sentence distance : 15
โ line 22
โ **General
โ **๋ฒ์ฉ
=> sentence distance : 7
โ line 22
โ Configuration**
โ ๊ตฌ์ฑ**
=> sentence distance : 13
โ line 23
โ Name of the sovereign cloud
โ ์๋ฒ๋ฆฐ ํด๋ผ์ฐ๋ ์ด๋ฆ
=> sentence distance : 25
โ line 24
โ subscription
โ ๊ตฌ๋
=> sentence distance : 12
โ line 25
โ Resource Group
โ ๋ฆฌ์์ค ๊ทธ๋ฃน
=> sentence distance : 13
64 words added. 69 words deleted.
Added words rate 34.97267759562842% (64 / 183 words)
Deleted words rate 37.704918032786885% (69 / 183 words)
-
mgmt_namespaces.md : File Modified +31 / -27 ๐ 58
โ line 1
โ Namespace Group
โ ๋ค์์คํ์ด์ค ๊ทธ๋ฃน
=> sentence distance : 14
โ line 1
โ Functional Area
โ ๊ธฐ๋ฅ ์์ญ
=> sentence distance : 14
โ line 3
โ or
โ ๋๋
=> sentence distance : 2
โ line 3
โ Frameworks
โ Frameworks์ ๊ฐ์ ์ ํ๋ฆฌ์ผ์ด์ ๋ชจ๋ธ
=> sentence distance : 14
โ line 3
โ Application models, such as
โ None
=> sentence distance : None
โ line 4
โ Virtual machines, containers, and other compute services
โ ๊ฐ์ ๋จธ์ , ์ปจํ ์ด๋ ๋ฐ ๊ธฐํ ์ปดํจํ ์๋น์ค
=> sentence distance : 49
โ line 5
โ Integration services (such as
โ ํตํฉ ์๋น์ค (์์:
=> sentence distance : 26
โ line 6
โ Management services (such as
โ ๊ด๋ฆฌ ์๋น์ค (์์:
=> sentence distance : 25
โ line 7
โ WAN, and Networking
โ WAN ๋ฐ ๋คํธ์ํน๊ณผ ๊ฐ์ ์๋น์ค
=> sentence distance : 15
โ line 7
โ Services such as
โ None
=> sentence distance : None
31 words added. 27 words deleted.
Added words rate 53.44827586206896% (31 / 58 words)
Deleted words rate 46.55172413793103% (27 / 58 words)
-
-
-
_posts
-
2019-11-11-november-ga-release.md : File Added ๐ 16
16 words added. -
2019-12-13-december-release.md : File Added ๐ 16
16 words added. -
2020-01-13-january-release.md : File Added ๐ 16
16 words added. -
2020-02-11-february-release.md : File Added ๐ 16
16 words added. -
2020-02-25-defaultazurecredentials.md : File Added ๐ 16
16 words added. -
2020-03-02-java-pluggable-http.md : File Added ๐ 20
20 words added. -
2020-03-10-monorepo.md : File Added ๐ 18
18 words added. -
2020-03-17-march-release.md : File Added ๐ 16
16 words added. -
2020-03-24-python-tracing.md : File Added ๐ 20
20 words added. -
2020-03-31-aspnet-core-integration.md : File Added ๐ 20
20 words added. -
2020-04-07-java-eventprocessorclient.md : File Added ๐ 21
21 words added. -
2020-04-14-april-release.md : File Added ๐ 16
16 words added. -
2020-04-21-js-cancellation.md : File Added ๐ 27
27 words added. -
2020-04-28-net-cancellation.md : File Added ๐ 24
24 words added. -
2020-05-05-jupyter-notebooks.md : File Added ๐ 22
22 words added. -
2020-05-12-may-release.md : File Added ๐ 18
18 words added. -
2020-05-19-formrecognizer.md : File Added ๐ 19
19 words added. -
2020-05-26-async-iterators.md : File Added ๐ 23
23 words added.
-
-
docs
-
android
-
design.md : File Modified +23 / -14 ๐ 12170
โ line 345
โ include a `getLatest()` method on the client's API version enum which returns
โ return
=> sentence distance : 71
โ line 345
โ preview
โ stable
=> sentence distance : 6
โ line 345
โ latest GA API version for stable SDKs.
โ service that is supported by the client using the enum's `getLatest()` method.
=> sentence distance : 61
โ line 345
โ beta SDKs and
โ None
=> sentence distance : None
23 words added. 14 words deleted.
Added words rate 0.18898931799506982% (23 / 12170 words)
Deleted words rate 0.11503697617091208% (14 / 12170 words)
-
implementation.md : File Modified +1165 / -845 ๐ 1353
โ line 2
โ Guidelines: Implementation"
โ ๊ฐ์ด๋๋ผ์ธ: ๊ตฌํ"
=> sentence distance : 24
โ line 9
โ Implementation
โ ๊ตฌํ
=> sentence distance : 14
โ line 11
โ This section describes guidelines for implementing
โ ์ด ๋ฌธ์๋
=> sentence distance : 49
โ line 11
โ client libraries. Please note that some of these guidelines are automatically enforced by code generation tools.
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ๊ตฌํํ๊ธฐ ์ํ ๊ฐ์ด๋๋ผ์ธ์ ๋๋ค. ์ด ๊ฐ์ด๋๋ผ์ธ์ ์ผ๋ถ๋ ์ฝ๋ ์์ฑ ๋๊ตฌ์ ์ํด ์๋์ผ๋ก ์ ์ฉ๋ ์ ์ ์ ์ํ์๊ธฐ ๋ฐ๋๋๋ค.
=> sentence distance : 99
โ line 13
โ allow implementation code (that is, code that doesn't form part of the public API) to be mistaken as public API. There are two valid arrangements for implementation code, which in order of preference are the following:
โ ๊ตฌํ ์ฝ๋(์ฆ, ๊ณต๊ฐ API์ ์ผ๋ถ๋ฅผ ๊ตฌ์ฑํ์ง ์์ ์ฝ๋)๋ฅผ ๊ณต๊ฐ API๋ก ์ค์ธํ์ง ์๋๋ก ํ์ญ์์ค. ๊ตฌํ ์ฝ๋์๋ ๋ ๊ฐ์ง ์ ํจํ ์ฝ์ ์ด ์๋๋ฐ, ์ฐ์ ์์๋ ๋ค์๊ณผ ๊ฐ์ต๋๋ค:
=> sentence distance : 187
โ line 15
โ Implementation classes can be made package-private and placed within the same package as the consuming class.
โ ๊ตฌํ ํด๋์ค๋ฅผ ํจํค์ง-ํ๋ผ์ด๋น์ผ๋ก ๋ง๋ค๊ณ , ์ด๋ฅผ ์ฌ์ฉํ๋ ํด๋์ค์ ๊ฐ์ ํจํค์ง ๋ด์ ๋ฐฐ์นํ ์ ์์ต๋๋ค.
=> sentence distance : 96
โ line 16
โ Implementation classes can be placed within a subpackage named `implementation`.
โ ๊ตฌํ ํด๋์ค๋ฅผ `implementation`์ผ๋ก ๋ช ๋ช ๋ ์๋ธํจํค์ง ๋ด์ ๋ฐฐ์นํ ์ ์์ต๋๋ค.
=> sentence distance : 69
โ line 18
โ checks ensure that classes within an
โ ๊ฒ์ฌ๋
=> sentence distance : 36
โ line 18
โ package arenโt exposed through public API, but it is better that the API not be public in the first place, so preferring to have package-private is the better approach where practicable.
โ ํจํค์ง ๋ด์ ํด๋์ค๊ฐ ๊ณต๊ฐ API๋ฅผ ํตํด ๋ ธ์ถ๋์ง ์๋๋ก ํ์ธํฉ๋๋ค. ํ์ง๋ง ์ฐ์ API๋ฅผ ๊ณต๊ฐ API๋ก ๊ตฌํํ์ง ์๋ ๊ฒ์ด ์ข์ผ๋ฏ๋ก, ๊ฐ๋ฅํ๋ฉด ํจํค์ง-ํ๋ผ์ด๋น์ ์ ์ฉํ๋ ๊ฒ์ด ๋ ๋ซ์ต๋๋ค.
=> sentence distance : 158
โ line 20
โ Service Client
โ ์๋น์ค ํด๋ผ์ด์ธํธ
=> sentence distance : 13
โ line 22
โ Async Service Client
โ ๋น๋๊ธฐ ์๋น์ค ํด๋ผ์ด์ธํธ
=> sentence distance : 18
โ line 24
โ include blocking calls inside async client library code.
โ ๋น๋๊ธฐ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ๋ด์ ๋๊ธฐ ํจ์ ํธ์ถ์ ํฌํจํ์ญ์์ค.
=> sentence distance : 49
โ line 26
โ Pipeline
โ ํ์ดํ๋ผ์ธ ์ฌ์ฉํ๊ธฐ
=> sentence distance : 10
โ line 26
โ Using the
โ None
=> sentence distance : None
โ line 28
โ team has provided an
โ ํ์ ๊ตฌ์ฑ์ด๋ HTTP ์์ฒญ ๋ฑ์ ํก๋จ ๊ด์ฌ์ฌ(cross cutting concerns)์ ๊ดํ ์ผ๋ฐ์ ์ธ ๋งค์ปค๋์ฆ์ด ํฌํจ๋
=> sentence distance : 61
โ line 28
โ library that contains common mechanisms for cross cutting concerns such as configuration and doing HTTP requests.
โ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ์ ๊ณตํ๊ณ ์์ต๋๋ค.
=> sentence distance : 110
โ line 30
โ use the HTTP pipeline component within
โ REST endpoints๋ฅผ ์๋น์คํ๊ธฐ ์ํด
=> sentence distance : 33
โ line 30
โ for communicating to service REST endpoints.
โ ๋ด์ HTTP ํ์ดํ๋ผ์ธ ์ปดํฌ๋ํธ๋ฅผ ์ฌ์ฉํ์ญ์์ค.
=> sentence distance : 40
โ line 32
โ pipeline consists of a
โ pipeline์ ์ฌ๋ฌ ์ ์ฑ ์ ์ํด ๋ํ๋
=> sentence distance : 14
โ line 32
โ transport that is wrapped by multiple policies. Each policy is a control point during which the pipeline can modify either the request and/or response. We prescribe a default set of policies to standardize how client libraries interact with
โ transport๋ก ๊ตฌ์ฑ๋์ด ์๋ค. ๊ฐ ์ ์ฑ ์ ํ์ดํ๋ผ์ธ์ด ์์ฒญ ๋ฐ/๋๋ ์๋ต์ ์์ ํ ์ ์๋ ์ ์ด ์ง์ ์ ๋๋ค. ์ฐ๋ฆฌ๋ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๊ฐ
=> sentence distance : 213
โ line 32
โ services. The order in the list is the most sensible order for implementation.
โ ์๋น์ค์ ์ํธ ์์ฉํ๋ ๋ฐฉ๋ฒ์ ํ์คํํ๋ ๊ธฐ๋ณธ ์ ์ฑ ์ธํธ๋ฅผ ๊ท์ ํฉ๋๋ค. ๋ฆฌ์คํธ์ ์์๋ ๊ตฌํ์ ์์ด ๊ฐ์ฅ ํฉ๋ฆฌ์ ์ธ ์์์ ๋๋ค.
=> sentence distance : 69
โ line 34
โ include the following policies provided by
โ HTTP ํ์ดํ๋ผ์ธ์ ๊ตฌ์ฑํ ๋
=> sentence distance : 39
โ line 34
โ Core when constructing the HTTP pipeline:
โ Core์ ์ํด ์ ๊ณต๋๋ ์๋์ ์ ์ฑ ๋ค์ ํฌํจํ์ญ์์ค:
=> sentence distance : 32
โ line 43
โ use the policy implementations in
โ ๊ฐ๋ฅํ ํ
=> sentence distance : 32
โ line 43
โ Core whenever possible. Do not try to "write your own" policy unless it is doing something unique to your service. If you need another option to an existing policy, engage with the
โ Core์ ์ ์ฑ ๊ตฌํ์ ์ฌ์ฉํ์ญ์์ค. ์๋น์ค์ ๊ณ ์ ํ ๊ฒ์ด ์๋๋ผ๋ฉด ์ ์ฑ ์ "์ง์ ์์ฑํ๋ ค๊ณ " ํ์ง ๋ง์ญ์์ค. ๊ธฐ์กด ์ ์ฑ ์ ๋ค๋ฅธ ์ต์ ์ด ํ์ํ ๊ฒฝ์ฐ
=> sentence distance : 158
โ line 43
โ Board] to add the option.
โ Board]์ ํ๋ ฅํ์ฌ ์ต์ ์ ์ถ๊ฐํ์ญ์์ค.
=> sentence distance : 16
โ line 45
โ Annotations
โ ์ด๋ ธํ ์ด์
=> sentence distance : 11
โ line 47
โ Include the following annotations on the service client class. For example, this code sample shows a sample class demonstrating the use of these two annotations:
โ ์๋น์ค ํด๋ผ์ด์ธํธ ํด๋์ค์๋ ๋ค์์ ์ด๋ ธํ ์ด์ ์ ํฌํจํ์ญ์์ค. ์๋ฅผ ๋ค์ด, ์ด ์ฝ๋์์๋ ๋ ์ด๋ ธํ ์ด์ ์ ์ฌ์ฉํ๋ ์์ ํด๋์ค๋ฅผ ๋ณผ ์ ์์ต๋๋ค:
=> sentence distance : 141
โ line 59
โ Annotation
โ ์ด๋ ธํ ์ด์
=> sentence distance : 10
โ line 59
โ Location
โ ์์น
=> sentence distance : 8
โ line 59
โ Description
โ ์ค๋ช
=> sentence distance : 11
โ line 61
โ Service Client | Specifies the builder responsible for instantiating the service client, whether the API is asynchronous, and a reference back to the service interface (the interface annotated with `@ServiceInterface`).
โ ์๋น์ค ํด๋ผ์ด์ธํธ | ํด๋ผ์ด์ธํธ๋ฅผ ์ธ์คํด์คํํ๋ ๋น๋, API๊ฐ ๋น๋๊ธฐ์ธ์ง ์ฌ๋ถ, ์๋น์ค ์ธํฐํ์ด์ค(`@ServiceInterface` ์ด๋ ธํ ์ด์ ์ด ์๋ ์ธํฐํ์ด์ค)์ ๋ํ ์ฐธ์กฐ๋ฅผ ๋ช ์ํฉ๋๋ค.
=> sentence distance : 185
โ line 62
โ Service Method | Placed on all service client methods that do network operations.
โ ์๋น์ค ๋ฉ์๋ | ๋คํธ์ํฌ ๋์์ ์ํํ๋ ๋ชจ๋ ์๋น์ค ํด๋ผ์ด์ธํธ ๋ฉ์๋์ ๋ช ์ํฉ๋๋ค.
=> sentence distance : 69
โ line 64
โ Service Client Builder
โ ์๋น์ค ํด๋ผ์ด์ธํธ ๋น๋
=> sentence distance : 20
โ line 66
โ Annotations
โ ์ด๋ ธํ ์ด์
=> sentence distance : 11
โ line 68
โ annotation should be placed on any class that is responsible for instantiating service clients (that is, instantiating classes annotated with `@ServiceClient`). For example:
โ ์ด๋ ธํ ์ด์ ์ ์๋น์ค ํด๋ผ์ด์ธํธ ์ธ์คํด์คํ๋ฅผ ๋ด๋นํ๋ ํด๋์ค์ ๋ฐ๋์ ๋ช ์๋์ด์ผ ํฉ๋๋ค. (์ฆ, `@ServiceClient` ์ด๋ ธํ ์ด์ ์ด ์ ์ฉ๋ ํด๋์ค๋ฅผ ์ธ์คํด์คํํ๋ ํด๋์ค์ ๋ฐฐ์น๋์ด์ผ ํฉ๋๋ค.). ์์๋ ๋ค์๊ณผ ๊ฐ์ต๋๋ค:
=> sentence distance : 144
โ line 75
โ This builder states that it can build instances of `ConfigurationClient` and `ConfigurationAsyncClient`.
โ ์์ ๋น๋๋ `ConfigurationClient`์ `ConfigurationAsyncClient`์ ์ธ์คํด์ค๋ฅผ ์์ฑํ ์ ์๋ค๊ณ ๋ช ์ํฉ๋๋ค.
=> sentence distance : 76
โ line 77
โ Supporting Types
โ ์ง์ ํ์
=> sentence distance : 15
โ line 79
โ Model Types
โ ๋ชจ๋ธ ํ์
=> sentence distance : 10
โ line 81
โ Annotations
โ ์ด๋ ธํ ์ด์
=> sentence distance : 11
โ line 83
โ There are two annotations of note that should be applied on model classes, when applicable:
โ ์กฐ๊ฑด์ ํด๋นํ๋ ๊ฒฝ์ฐ, ๋ชจ๋ธ ํด๋์ค์ ์ ์ฉํด์ผ ํ๋ ๋ ๊ฐ์ง ์ด๋ ธํ ์ด์ ์ด ์์ต๋๋ค.
=> sentence distance : 81
โ line 85
โ annotation is applied to all model classes that are expected to provide a fluent API to end users.
โ ์ด๋ ธํ ์ด์ ์ ์ต์ข ์ฌ์ฉ์์๊ฒ Fluent API๋ฅผ ์ ๊ณตํ ๊ฒ์ผ๋ก ์์๋๋ ๋ชจ๋ ๋ชจ๋ธ ํด๋์ค์ ์ ์ฉ๋ฉ๋๋ค.
=> sentence distance : 84
โ line 85
โ The
โ None
=> sentence distance : None
โ line 86
โ annotation is applied to all immutable classes.
โ ์ด๋ ธํ ์ด์ ์ ๋ณ๊ฒฝํ ์ ์๋ ๋ชจ๋ ํด๋์ค์ ์ ์ฉ๋ฉ๋๋ค.
=> sentence distance : 41
โ line 86
โ The
โ None
=> sentence distance : None
โ line 90
โ Feature Implementation
โ ๊ธฐ๋ฅ ๊ตฌํ
=> sentence distance : 21
โ line 92
โ Configuration
โ ๊ตฌ์ฑ
=> sentence distance : 13
โ line 94
โ When configuring your client library, particular care must be taken to ensure that the consumer of your client library can properly configure the connectivity to your
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ๊ตฌ์ฑํ ๋, ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ์ฌ์ฉ์๊ฐ
=> sentence distance : 160
โ line 94
โ service both globally (along with other client libraries the consumer is using) and specifically with your client library. For Android applications, configuration can be applied in a variety of ways, such as through application preferences or using a
โ ์๋น์ค์ ๋ํ ์ ์์ ๊ธ๋ก๋ฒํ๊ณ (์ฌ์ฉ์๊ฐ ์ฌ์ฉํ๊ณ ์๋ ๋ค๋ฅธ ํด๋ผ์ด์ธํธ์ ํจ๊ป), ํนํ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์์ ์ ์์ ์ ์ ํ ์ค์ ํ ์ ์๋๋ก ํนํ ์ฃผ์ํด์ผ ํฉ๋๋ค. ์๋๋ก์ด๋ ์ดํ๋ฆฌ์ผ์ด์ ์ ๋ํด์, ์ค์ ์ ์ดํ๋ฆฌ์ผ์ด์ ํ๊ฒฝ์ค์ ๋๋
=> sentence distance : 223
โ line 94
โ file, to name a few.
โ ํ์ผ ์ฌ์ฉ ๋ฑ๊ณผ ๊ฐ์ ๋ค์ํ ๋ฐฉ๋ฒ์ผ๋ก ์ ์ฉํ ์ ์์ต๋๋ค.
=> sentence distance : 27
โ line 98
โ Logging
โ ๋ก๊น
=> sentence distance : 7
โ line 100
โ Client libraries must make use of the robust logging mechanisms in
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋
=> sentence distance : 65
โ line 100
โ Core, so that the consumers can adequately diagnose issues with method calls and quickly determine whether the issue is in the consumer code, client library code, or service.
โ Core์ ๊ฒฌ๊ณ ํ ๋ก๊น ๋ฉ์ปค๋์ฆ์ ์ฌ์ฉํ์ฌ ์ฌ์ฉ์๊ฐ ๋ฉ์๋ ํธ์ถ์ ๊ดํ ๋ฌธ์ ๋ฅผ ์ ์ ํ๊ฒ ์ง๋จํ๊ณ ๋ฌธ์ ๊ฐ ์ฌ์ฉ์์ ์ฝ๋, ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์ฝ๋ ๋๋ ์๋น์ค์ ์๋์ง ์ฌ๋ถ๋ฅผ ์ ์ํ๊ฒ ํ๋จํ ์ ์๋๋ก ํด์ผ ํฉ๋๋ค.
=> sentence distance : 145
โ line 102
โ Request logging will be done automatically by the `HttpPipeline`. If a client library needs to add custom logging, follow the same guidelines and mechanisms as the pipeline logging mechanism. If a client library wants to do custom logging, the designer of the library must ensure that the logging mechanism is pluggable in the same way as the
โ ์์ฒญ ๋ก๊น ์ `HttpPipeline`์ ์ํด ์๋์ผ๋ก ์ํ๋ฉ๋๋ค. ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์์ ์ปค์คํ ๋ก๊น ๋ฅผ ์ถ๊ฐํ ํ์๊ฐ ์๋ ๊ฒฝ์ฐ, ํ์ดํ๋ผ์ธ ๋ก๊น ๋ฉ์ปค๋์ฆ๊ณผ ๊ฐ์ ๊ฐ์ด๋๋ผ์ธ๊ณผ ๋ฉ์ปค๋์ฆ์ ๋ฐ๋ฅด์ญ์์ค. ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๊ฐ ์ปค์คํ ๋ก๊น ์ ์คํํ๊ณ ์ ํ๋ ๊ฒฝ์ฐ, ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์ค๊ณ์๋ ๋ก๊น ๋ฉ์ปค๋์ฆ์ด
=> sentence distance : 299
โ line 102
โ logging policy.
โ ๋ก๊น ์ ์ฑ ๊ณผ ๋์ผํ ๋ฐฉ๋ฒ์ผ๋ก ์ ์ ๊ฐ๋ฅํจ์ ๋ณด์ฅํด์ผ ํฉ๋๋ค.
=> sentence distance : 31
โ line 104
โ follow [the logging section of the Azure
โ (`HttpPipeline` ๊ฒฝ์ ๊ฐ ์๋) ์ง์ ๋ก๊น ํ๋ ๊ฒฝ์ฐ [Azure
=> sentence distance : 33
โ line 104
โ General Guidelines][logging-general-guidelines] and [the following guidelines](#using-the-clientlogger-interface) if logging directly (as opposed to through the `HttpPipeline`).
โ ๊ณตํต ๊ฐ์ด๋๋ผ์ธ ๋ก๊น ์น์ ][logging-general-guidelines]๋ฐ [๋ค์ ๊ฐ์ด๋๋ผ์ธ](#clientlogger-์ธํฐํ์ด์ค-์ฌ์ฉ)์ ๋ฐ๋ฅด์ญ์์ค.
=> sentence distance : 126
โ line 106
โ interface
โ ์ธํฐํ์ด์ค ์ฌ์ฉ
=> sentence distance : 9
โ line 106
โ Using the
โ None
=> sentence distance : None
โ line 108
โ Core as the sole logging API throughout all client libraries. Internally,
โ Core์์ ์ ๊ณต๋๋
=> sentence distance : 68
โ line 108
โ logs to the
โ API๋ฅผ ๋ชจ๋ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์์ ์ ์ผํ ๋ก๊น API๋ก ์ฌ์ฉํฉ๋๋ค. ๋ด๋ถ์ ์ผ๋ก, `ClientLogger`๋
=> sentence distance : 59
โ line 108
โ buffer.
โ ๋ฒํผ์ ๊ธฐ๋ก๋ฉ๋๋ค.
=> sentence distance : 9
โ line 108
โ use the `ClientLogger` API provided within
โ None
=> sentence distance : None
โ line 112
โ create a new instance of a
โ ๋ชจ๋ ๊ด๋ จ ํด๋์ค์ ์ธ์คํด์ค๋ณ๋ก `ClientLogger`์ ์ ์ธ์คํด์ค๋ฅผ ๋ง๋ญ๋๋ค. ์๋ฅผ ๋ค์ด, ์๋์ ์ฝ๋๋ `ConfigurationAsyncClient`์ฉ
=> sentence distance : 80
โ line 112
โ per instance of all relevant classes. For example, the code below will create a `ClientLogger` instance for the `ConfigurationAsyncClient`:
โ ์ธ์คํด์ค๋ฅผ ์์ฑํฉ๋๋ค:
=> sentence distance : 137
โ line 129
โ Don't create static logger instances. Static logger instances are long-lived and the memory allocated to them is not released until the application is terminated.
โ ์ ์ ๋ก๊ฑฐ ์ธ์คํด์ค๋ฅผ ์์ฑํ์ง ๋ง์ญ์์ค. ์ ์ ๋ก๊ฑฐ ์ธ์คํด์ค๋ ์๋ช ์ด ๊ธธ๋ฉฐ ์ ํ๋ฆฌ์ผ์ด์ ์ด ์ข ๋ฃ๋ ๋๊น์ง ํ ๋น๋ ๋ฉ๋ชจ๋ฆฌ๊ฐ ํด์ ๋์ง ์์ต๋๋ค.
=> sentence distance : 144
โ line 131
โ all exceptions created within the client library code through one of the logger APIs
โ ๋ก๊ฑฐ API ์ค ํ๋๋ฅผ ํตํด ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์ฝ๋ ๋ด์ ์์ฑ๋ ๋ชจ๋ ์์ธ๋ฅผ-] throw [-ํ์ญ์์ค
=> sentence distance : 72
โ line 131
โ `ClientLogger.logExceptionAsError()` or
โ `ClientLogger.logExceptionAsError()`,
=> sentence distance : 3
โ line 131
โ None
โ ๋ก๊ฑฐ API ์ค ํ๋๋ฅผ ํตํด ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์ฝ๋ ๋ด์ ์์ฑ๋ ๋ชจ๋ ์์ธ๋ฅผ
=> sentence distance : None
โ line 133
โ For example:
โ ์๋ฅผ ๋ค์ด:
=> sentence distance : 10
โ line 164
โ Distributed tracing
โ ๋ถ์ฐ ํธ๋ ์ด์ค
=> sentence distance : 18
โ line 166
โ Distributed tracing is uncommon in a mobile context. If you feel like you need to support distributed tracing, contact the
โ ๋ถ์ฐ ํธ๋ ์ด์ค๋ ๋ชจ๋ฐ์ผ์ปจํ ์คํธ์์๋ ๊ฑฐ์ ๋ฐ์ํ์ง ์์ต๋๋ค. ๋ถ์ฐ ํธ๋ ์ด์ค๋ฅผ ์ํฌํธํ ํ์๊ฐ ์๋ ๊ฒฝ์ฐ๋,
=> sentence distance : 109
โ line 166
โ mobile team](mailto:azuresdkmobileteam@microsoft.com) for advice.
โ ๋ชจ๋ฐ์ผ ํ](mailto:azuresdkmobileteam@microsoft.com)์ ๋ฌธ์ํด ์ฃผ์ญ์์ค.
=> sentence distance : 20
โ line 168
โ Testing
โ ํ ์คํ
=> sentence distance : 7
โ line 170
โ One of the key things we want to support is to allow consumers of the library to easily write repeatable unit-tests for their applications without activating a service. This allows them to reliably and quickly test their code without worrying about the vagaries of the underlying service implementation (including, for example, network conditions or service outages). Mocking is also helpful to simulate failures, edge cases, and hard to reproduce situations (for example: does code work on February 29th).
โ ์ฐ๋ฆฌ๊ฐ ์ง์ํ๊ณ ์ถ์ ํต์ฌ ์ฌํญ ์ค ํ๋๋ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์ด์ฉ์๊ฐ ์๋น์ค๋ฅผ ํ์ฑํํ์ง ์๊ณ ๋ ์ ํ๋ฆฌ์ผ์ด์ ์ ๋ํด ๋ฐ๋ณต ๊ฐ๋ฅํ ์ ๋ ํ ์คํธ๋ฅผ ์ฝ๊ฒ ์์ฑํ ์ ์๋๋ก ํ๋ ๊ฒ์ ๋๋ค. ์ด๋ ๊ธฐ๋ฐ์ด ๋๋ ์๋น์ค ๊ตฌํ์ ์์ ๋ฐ์ ๋ฌธ์ (๋คํธ์ํฌ์ ์ํ๋ ์๋น์ค์ ์ ์ง๋ฑ)์ ๋ํด ์ผ๋ คํ์ง ์๊ณ , ์ฝ๋๋ฅผ ํ์คํ๊ณ ๋น ๋ฅด๊ฒ ํ ์คํธํ ์ ์์ต๋๋ค. ๋ชจ์ ๊ฐ์ฒด๋ ์ฅ์ , ์ฃ์ง ์ผ์ด์ค, ์ฌํํ๊ธฐ ์ด๋ ค์ด ์ํฉ(์ฝ๋๊ฐ 2์ 29์ผ์๋ ์๋ํ์ง ์๋ ๊ฒฝ์ฐ)์ ์๋ฎฌ๋ ์ดํธํ๋๋ฐ๋ ๋์์ด ๋ฉ๋๋ค.
=> sentence distance : 443
โ line 172
โ parameterize all applicable unit tests to make use of all available
โ ์ฌ์ฉ ๊ฐ๋ฅํ ๋ชจ๋
=> sentence distance : 65
โ line 172
โ clients and service versions. Parameterized runs of all tests must occur as part of live tests. Shorter runs, consisting of just Netty and the latest service version, can be run whenever
โ ํด๋ผ์ด์ธํธ ๋ฐ ์๋น์ค ๋ฒ์ ์ ์ฌ์ฉํ๊ธฐ ์ํด ์ ์ฉ ๊ฐ๋ฅํ ๋ชจ๋ ์ ๋ ํ ์คํธ๋ฅผ ํ๋ผ๋ฏธํฐํํ์ญ์์ค. ๋ชจ๋ ํ ์คํธ์ ํ๋ผ๋ฏธํฐํ๋ ์คํ์ ๋ผ์ด๋ธ ํ ์คํธ์ ์ผ๋ถ๋ก ์ํ๋์ด์ผ ํฉ๋๋ค.
=> sentence distance : 165
โ line 172
โ validation occurs.
โ ์ ํจ์ฑ ๊ฒ์ฌ๊ฐ ๋ฐ์ํ ๋๋ง๋ค ๋ ์งง์ ์คํ(Netty ๋ฐ ์ต์ ์๋น์ค ๋ฒ์ )์ ์คํํ ์ ์์ต๋๋ค.
=> sentence distance : 52
โ line 176
โ Other Android-related considerations
โ ๊ธฐํ Android ๊ด๋ จ ๊ณ ๋ ค ์ฌํญ
=> sentence distance : 27
โ line 180
โ developers need to concern themselves with the runtime environment they are running in. The
โ ๊ฐ๋ฐ์๋ค์ ์์ ์ด ์คํํ๊ณ ์๋ ๋ฐํ์ ํ๊ฒฝ์ ๋ํด ๊ณ ๋ คํ ํ์๊ฐ ์์ต๋๋ค.
=> sentence distance : 81
โ line 180
โ ecosystem is fragmented, with a wide variety of runtimes deployed.
โ ์ํ๊ณ๋ ๋งค์ฐ ๋ค์ํ ๋ฐํ์์ผ๋ก ๋ถํ ๋์ด ์์ต๋๋ค.
=> sentence distance : 60
โ line 182
โ support at least
โ ์ต์
=> sentence distance : 16
โ line 182
โ and later (Ice
โ ์ด์์ ์ง์ํ์ญ์์ค(Ice
=> sentence distance : 9
โ line 182
โ This value can be found in your project's top level
โ ํด๋น ๊ฐ์ ํ๋ก์ ํธ์ ์ต์์ ๋ ๋ฒจ
=> sentence distance : 47
โ line 182
โ file as `minSdkVersion`.
โ ํ์ผ์ `minSdkVersion`์์ ์ฐพ์ ์ ์์ต๋๋ค.
=> sentence distance : 19
โ line 184
โ There are two things that are of concern when discussing the minimum
โ ์ต์
=> sentence distance : 68
โ line 184
โ level to choose:
โ ์์ค ์ ํ์ ๋ํด ๋ ผ์ํ ๋ ๋ค์ ๋ ๊ฐ์ง ์ฌํญ์ ๊ณ ๋ คํด์ผ ํฉ๋๋ค:
=> sentence distance : 34
โ line 186
โ The minimum
โ Google์ด ์ง์ํ๋ ์ต์
=> sentence distance : 13
โ line 186
โ level that Google supports.
โ ๋ ๋ฒจ
=> sentence distance : 27
โ line 187
โ The reach of selecting a particular
โ ์ ํํ๋ ํน์
=> sentence distance : 34
โ line 187
โ level.
โ ์์ค์ ๋๋ฌ ๋ฒ์
=> sentence distance : 9
โ line 189
โ We require the minimum API level that Google supports that reaches the most Android devices while still allowing for the use of widely adopted tools by the developer community, such as popular
โ ์ฐ๋ฆฌ๋ ์ธ๊ธฐ ์๋
=> sentence distance : 190
โ line 189
โ clients or serialization libraries. We have currently landed on
โ ํด๋ผ์ด์ธํธ๋ ์ง๋ ฌํ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๊ฐ์ด ๊ฐ๋ฐ์ ์ปค๋ฎค๋ํฐ์์ ์ฌ์ ํ ๋๋ฆฌ ์ ์ฉ๋๋ ํด์ ์ฌ์ฉํ ์ ์๋ ์๋๋ก์ด๋ ์ฅ์น๊ฐ ๋๋ฌํ ์ ์๋๋ก ๊ตฌ๊ธ์ด ์ง์ํ๋ ์ต์
=> sentence distance : 77
โ line 189
โ level 15, which covers more than
โ ๋ ๋ฒจ์ ์๊ตฌํฉ๋๋ค. ์ฐ๋ฆฌ๋ ํ์ฌ
=> sentence distance : 29
โ line 189
โ of all Android devices (as of May 2021). The reach of a particular
โ ์ด์์ ์ปค๋ฒํ๋
=> sentence distance : 65
โ line 189
โ can be found when clicking
โ 15(2021๋ 5์ ๊ธฐ์ค)์ ์ ์ฐฉํ๊ณ ์์ต๋๋ค. ํน์ API ์์ค์ ๋๋ฌ ๋ฒ์๋ ์๋๋ก์ด๋ ์คํ๋์ค์์ "Create New Project" ํ๋ฉด์์ ์์ฑํ ํ๋ก์ ํธ ์ ํ์ ์ ํํ ํ
=> sentence distance : 96
โ line 189
โ in Android Studio's "Create New Project" screen, after selecting the type of project to create.
โ ๋ฅผ ํด๋ฆญํ๋ฉด ํ์ธํ ์ ์์ต๋๋ค.
=> sentence distance : 90
โ line 191
โ set the `targetSdkVersion` to be
โ ํ๋ก์ ํธ์ ์ต์์ `build.gradle` ํ์ผ์์ `targetSdkVersion`์
=> sentence distance : 33
โ line 191
โ level
โ ์์ค
=> sentence distance : 5
โ line 191
โ or higher in your project's top level `build.gradle` file.
โ ์ด์์ผ๋ก ์ค์ ํ์ญ์์ค.
=> sentence distance : 56
โ line 193
โ As of November 2018, all existing
โ 2018๋ 11์ ํ์ฌ ๋ชจ๋ ๊ธฐ์กด
=> sentence distance : 27
โ line 193
โ apps are required to target
โ ์ฑ์
=> sentence distance : 27
โ line 193
โ level
โ ๋ ๋ฒจ
=> sentence distance : 5
โ line 193
โ or higher. For more information, see [Improving app security and performance on
โ ์ด์์ ๋์์ผ๋ก ํด์ผ ํฉ๋๋ค. ์์ธํ ๋ด์ฉ์ [ํฅํ
=> sentence distance : 73
โ line 193
โ Play for years to come](https://android-developers.googleblog.com/2017/12/improving-app-security-and-performance.html).
โ Play์์ ์ฑ ๋ณด์ ๋ฐ ์ฑ๋ฅ ํฅ์](https://android-developers.googleblog.com/2017/12/improving-app-security-and-performance.html)์ ์ฐธ์กฐํ์ญ์์ค.
=> sentence distance : 23
โ line 195
โ set the `maxSdkVersion` to be the latest
โ `maxSdkVersion`์ ํ๋ก์ ํธ์ ์ต์์ `build.gradle` ํ์ผ์์ ํ ์คํธ๋ฅผ ์คํํ๋ ์ต์
=> sentence distance : 46
โ line 195
โ level that you have run tests on in your project's top level `build.gradle` file. This should be the latest
โ ์์ค์ผ๋ก ์ค์ ํ์ญ์์ค. ์ด๋ SDK๊ฐ ์ถ์๋๋ ์์ ์ Google์ด ์ง์ํ๋ ์ต์
=> sentence distance : 94
โ line 195
โ level that is supported by Google at the point at which the SDK is released.
โ ์์ค์ด์ด์ผ ํฉ๋๋ค.
=> sentence distance : 74
โ line 197
โ project's
โ ํ๋ก์ ํธ์
=> sentence distance : 9
โ line 197
โ and
โ ๋ฐ
=> sentence distance : 3
โ line 197
โ level to `1.8`.
โ ์์ค์ `1.8`๋ก ์ค์ ํ์ญ์์ค.
=> sentence distance : 16
โ line 197
โ set your
โ None
=> sentence distance : None
โ line 199
โ release the library as an
โ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ
=> sentence distance : 25
โ line 199
โ AAR.
โ AAR๋ก ๋ฆด๋ฆฌ์คํ์ญ์์ค.
=> sentence distance : 9
โ line 201
โ define a `resourcePrefix` of `azure_` in the `build.gradle` android section if using resources.
โ ๋ฆฌ์์ค๋ฅผ ์ฌ์ฉํ๋ ๊ฒฝ์ฐ `build.gradle`์ ์๋๋ก์ด๋ ์น์ ์์ `azure_`์ `resourcePrefix`๋ฅผ ์ ์ํ์ญ์์ค.
=> sentence distance : 81
โ line 203
โ include a
โ AAR์๋ ๊ฐ๋ฐ์๊ฐ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ์ฌ์ฉํ ๋ ์ ํ๋ฆฌ์ผ์ด์ ์ ์ฌ๋ฐ๋ฅด๊ฒ ์ต์ํํ๋ ๊ฒ์ ๋ณด์กฐํ ์ ์๋๋ก
=> sentence distance : 54
โ line 203
โ configuration in the AAR to assist developers in correctly minifying their applications when using the library.
โ ๊ตฌ์ฑ์ด ํฌํจ๋์ด ์์ด์ผ ํฉ๋๋ค.
=> sentence distance : 107
โ line 205
โ use `consumerProguardFiles` if you include a
โ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์
=> sentence distance : 44
โ line 205
โ configuration in the library.
โ ๊ตฌ์ฑ์ ํฌํจํ๋ ๊ฒฝ์ฐ `consumerProguardFiles`๋ฅผ ์ฌ์ฉํ์ญ์์ค.
=> sentence distance : 38
</details>1165 words added. 845 words deleted.
Added words rate 86.1049519586105% (1165 / 1353 words)
Deleted words rate 62.45380635624538% (845 / 1353 words)
-
refs.md : File Modified +1 / -1 ๐ 53
โ line 7
โ https://azure.github.io/azure-sdk/general_implementation.html#logging
โ https://azure.github.io/azure-sdk-korean/general_implementation.html#logging
=> sentence distance : 7
1 words added. 1 words deleted.
Added words rate 1.8867924528301887% (1 / 53 words)
Deleted words rate 1.8867924528301887% (1 / 53 words)
-
-
clang
-
approved_dependencies.md : File Added ๐ 8
8 words added. -
design.md : File Added ๐ 8633
8633 words added. -
implementation.md : File Added ๐ 5924
5924 words added. -
refs.md : File Added ๐ 9
9 words added.
-
-
cpp
-
approved_dependencies.md : File Added ๐ 58
58 words added. -
implementation.md : File Added ๐ 5330
5330 words added. -
introduction.md : File Added ๐ 8069
8069 words added. -
refs.md : File Added ๐ 10
10 words added.
-
-
dotnet
-
implementation.md : File Modified +3 / -3 ๐ 2926
โ line 51
โ Response
โ var
=> sentence distance : 8
โ line 139
โ JsonElement
โ var
=> sentence distance : 11
โ line 480
โ Type
โ var
=> sentence distance : 4
3 words added. 3 words deleted.
Added words rate 0.10252904989747096% (3 / 2926 words)
Deleted words rate 0.10252904989747096% (3 / 2926 words)
-
introduction.md : File Modified +73 / -211 ๐ 6825
โ line 67
โ are
โ will be
=> sentence distance : 6
โ line 67
โ [service client](#dotnet-client)
โ _service client_
=> sentence distance : 18
โ line 67
โ [supporting types](#supporting-types). The supporting types may include various [subclients](#dotnet-subclients), which give structure to the API by organizing groups of related service operations, and [model types](#dotnet-model-types), which represent resources on the service.
โ _supporting types_.
=> sentence distance : 263
โ line 147
โ None
โ #### Client Hierarchies {#dotnet-client-hierarchy}
=> sentence distance : None
โ line 149
โ None
โ Some Azure services store and manipulate resources organized in a hierarchy. For example, Azure Storage provides an account that contains zero or more containers, which in turn contain zero or more blobs.
=> sentence distance : None
โ line 150
โ None
โ SDK libraries for such services might want to provide more than one client type representing various levels of the hierarchy. For example, the storage library provides `BlobServiceClient`, `BlobContainerClient`, and `BlobClient`.
=> sentence distance : None
โ line 152
โ None
โ {% include requirement/MAY id="dotnet-client-hierarchy-clients" %} provide a client type corresponding to each level in a resource hierarchy.
=> sentence distance : None
โ line 154
โ None
โ {% include requirement/MUST id="dotnet-client-hierarchy-get" %} provide a `.Get Client(...)` method to retrieve a client for the named child.
=> sentence distance : None
โ line 156
โ None
โ For example, `BlobContainerClient` has a method [`GetBlobClient`](https://docs.microsoft.com/en-us/dotnet/api/azure.storage.blobs.blobcontainerclient.getblobclient?view=azure-dotnet#Azure_Storage_Blobs_BlobContainerClient_GetBlobClient_System_String_) returning an instance of `BlobClient`. The method must not make a network call to verify the existence of the child.
=> sentence distance : None
โ line 157
โ None
โ Also, note that per general client constructor guidelines, all clients need to provide at least one public constructor.
=> sentence distance : None
โ line 159
โ None
โ {% include requirement/MAY id="dotnet-client-hierarchy-create" %} provide method `.Create (...)` that creates a child resource.
=> sentence distance : None
โ line 161
โ None
โ The method **should** return an instance of a client for the newly created child resource.
=> sentence distance : None
โ line 163
โ None
โ {% include requirement/MAY id="dotnet-client-hierarchy-delete" %} provide method `.Delete (...)` that deletes a child resource.
=> sentence distance : None
โ line 182
โ name, such as `ClientOptions`.
โ plural or-] more general [-name.
=> sentence distance : 37
โ line 182
โ `BlobClientOptions`
โ `BlobClientsOptions`
=> sentence distance : 1
โ line 182
โ None
โ plural or
=> sentence distance : None
โ line 525
โ sent
โ directly passed
=> sentence distance : 13
โ line 525
โ service as URL segments, query parameters, request header values, and request bodies (typically JSON or XML).
โ service.
=> sentence distance : 101
โ line 525
โ are not sent
โ aren't passed directly
=> sentence distance : 14
โ line 525
โ service; examples are path parameters, CancellationTokens or file paths.
โ service.
=> sentence distance : 64
โ line 525
โ solely
โ None
=> sentence distance : None
โ line 604
โ Responseresponse
โ var value
=> sentence distance : 21
โ line 605
โ Console.WriteLine(response.Value);
โ Console.WriteLine(value);
=> sentence distance : 10
โ line 627
โ long
โ var
=> sentence distance : 4
</details>73 words added. 211 words deleted.
Added words rate 1.0695970695970698% (73 / 6825 words)
Deleted words rate 3.0915750915750917% (211 / 6825 words)
-
refs.md : File Modified +1 / -1 ๐ 27
โ line 7
โ https://docs.microsoft.com/dotnet/standard/net-standard
โ https://github.com/dotnet/standard/blob/master/docs/versions/netstandard2.0.md
=> sentence distance : 46
1 words added. 1 words deleted.
Added words rate 3.7037037037037033% (1 / 27 words)
Deleted words rate 3.7037037037037033% (1 / 27 words)
-
-
general
-
azurecore.md : File Modified +2396 / -1874 ๐ 2345
โ line 2
โ "General Guidelines:
โ "๊ณตํต ๊ฐ์ด๋๋ผ์ธ:
=> sentence distance : 17
โ line 9
โ is a library that provides cross-cutting services to other client libraries. These services include:
โ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ ๋ค๋ฅธ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ๊ต์ฐจ ์๋น์ค๋ฅผ ์ ๊ณตํฉ๋๋ค. ์ด๋ฌํ ์๋น์ค๋ ๋ค์๊ณผ ๊ฐ์ต๋๋ค:
=> sentence distance : 90
โ line 11
โ pipeline
โ ํ์ดํ๋ผ์ธ
=> sentence distance : 8
โ line 11
โ The
โ None
=> sentence distance : None
โ line 12
โ Global configuration
โ ์ ์ญ ๊ตฌ์ฑ
=> sentence distance : 19
โ line 13
โ Credentials
โ ์๊ฒฉ ์ฆ๋ช
=> sentence distance : 11
โ line 15
โ The following sections define the requirements for the
โ ๋ค์ ์ ์์๋
=> sentence distance : 53
โ line 15
โ library. If you are implementing a client library in a language that already has an
โ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ๋ํ ์๊ตฌ ์ฌํญ์ ์ ์ํฉ๋๋ค.
=> sentence distance : 80
โ line 15
โ library, you do not need to read this section. It is primarily targeted at developers who work on the
โ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ์ด๋ฏธ ๊ฐ๊ณ ์๋ ์ธ์ด๋ก ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ๊ตฌํํ๋ ๊ฒฝ์ฐ, ์ด ์น์ ์ ์ฝ์ ํ์๊ฐ ์์ต๋๋ค. ์ฃผ๋ก
=> sentence distance : 89
โ line 15
โ library.
โ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์์ ์ผํ๋ ๊ฐ๋ฐ์๋ฅผ ๋์์ผ๋ก ํฉ๋๋ค.
=> sentence distance : 25
โ line 17
โ pipeline
โ ํ์ดํ๋ผ์ธ
=> sentence distance : 8
โ line 17
โ The
โ None
=> sentence distance : None
โ line 19
โ pipeline consists of a
โ ํ์ดํ๋ผ์ธ์ ์ฌ๋ฌ ์ ์ฑ ์ผ๋ก ๊ตฌ์ฑ๋
=> sentence distance : 20
โ line 19
โ transport that is wrapped by multiple policies. Each policy is a control point during which the pipeline can modify either the request and/or response. We use a default set of policies to standardize how client libraries interact with
โ ์ ์ก์ผ๋ก ๊ตฌ์ฑ๋ฉ๋๋ค. ๊ฐ ์ ์ฑ ์ ํ์ดํ๋ผ์ธ์ด ์์ฒญ ๊ทธ๋ฆฌ๊ณ /๋๋ ์๋ต์ ์์ ํ ์ ์๋ ์ ์ด ์ง์ ์ ๋๋ค. ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๊ฐ
=> sentence distance : 220
โ line 19
โ services.
โ ์๋น์ค์ ์ํธ ์์ฉํ๋ ๋ฐฉ์์ ํ์คํํ๊ธฐ ์ํด ๊ธฐ๋ณธ ์ ์ฑ ์งํฉ์ ์ฌ์ฉํฉ๋๋ค.
=> sentence distance : 41
โ line 21
โ Telemetry
โ ์๊ฒฉ ๋ถ์
=> sentence distance : 9
โ line 22
โ Unique request
โ ๊ณ ์ ํ ์์ฒญ
=> sentence distance : 13
โ line 23
โ Retry
โ ์ฌ์๋
=> sentence distance : 5
โ line 24
โ Authentication
โ ์ธ์ฆ
=> sentence distance : 14
โ line 25
โ Response downloader
โ ์๋ต ๋ค์ด๋ก๋
=> sentence distance : 18
โ line 26
โ Distributed tracing
โ ๋ถ์ฐ ์ถ์
=> sentence distance : 18
โ line 27
โ Logging
โ ๋ก๊น
=> sentence distance : 7
โ line 28
โ Proxy
โ ํ๋ก์
=> sentence distance : 5
โ line 30
โ In general, the client library will only need to configure these policies. However, if you are producing a new
โ ์ผ๋ฐ์ ์ผ๋ก ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ ์ด๋ฌํ ์ ์ฑ ๋ง ๊ตฌ์ฑํ๋ฉด ๋ฉ๋๋ค. ๊ทธ๋ฌ๋ (์๋ก์ด ์ธ์ด๋ฅผ ์ํ) ์๋ก์ด
=> sentence distance : 99
โ line 30
โ library (for a new language), you will need to understand the requirements for each policy.
โ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ์์ฑํ๋ ๊ฒฝ์ฐ, ๊ฐ ์ ์ฑ ์ ๋ํ ์๊ตฌ ์ฌํญ์ ์ดํดํด์ผ ํฉ๋๋ค.
=> sentence distance : 80
โ line 32
โ Telemetry policy
โ ์๊ฒฉ ๋ถ์ ์ ์ฑ
=> sentence distance : 15
โ line 34
โ Client library usage telemetry is used by service teams (not consumers) to monitor what
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์ฌ์ฉ ์๊ฒฉ ๋ถ์์ (์๋น์๊ฐ ์๋) ์๋น์ค ํ์์ ํด๋ผ์ด์ธํธ๊ฐ ์๋น์ค์ ํธ์ถํ๋ ๋ฐ ์ฌ์ฉํ๋
=> sentence distance : 77
โ line 34
โ language, client library version, and language/platform info a client is using to call into their service. Clients can prepend additional information indicating the name and version of the client application.
โ ์ธ์ด, ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ๋ฐ ์ธ์ด/ํ๋ซํผ ์ ๋ณด๋ฅผ ๋ชจ๋ํฐ๋งํ๋ ๋ฐ ์ฌ์ฉ๋ฉ๋๋ค. ํด๋ผ์ด์ธํธ๋ ํด๋ผ์ด์ธํธ ์ ํ๋ฆฌ์ผ์ด์ ์ ์ด๋ฆ๊ณผ ๋ฒ์ ์ ๋ํ๋ด๋ ์ถ๊ฐ ์ ๋ณด๋ฅผ ์์ ์ถ๊ฐํ ์ ์์ต๋๋ค.
=> sentence distance : 184
โ line 36
โ send telemetry information in the
โ ๋ค์ ํ์์ ์ฌ์ฉํ์ฌ
=> sentence distance : 31
โ line 36
โ header] using the following format:
โ ํค๋]๋ก ์๊ฒฉ ์ธก์ ์ ๋ณด๋ฅผ ์ ์กํ์ญ์์ค:
=> sentence distance : 30
โ line 42
โ optional application-specific string. May contain a slash, but must not contain a space. The string is supplied by the user of the client library, e.g.
โ ์ ํ์ ์ ํ๋ฆฌ์ผ์ด์ ๋ณ ๋ฌธ์์ด. ์ฌ๋์๋ฅผ ํฌํจํ ์ ์์ง๋ง, ๊ณต๋ฐฑ์ ํฌํจํด์๋ ์ ๋ฉ๋๋ค. ๋ฌธ์์ด์ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ์ฌ์ฉ์๊ฐ ์ ๊ณตํฉ๋๋ค. ์์:
=> sentence distance : 133
โ line 43
โ SDK's language name (all lowercase):
โ SDK ์ธ์ด ์ด๋ฆ (๋ชจ๋ ์๋ฌธ์):
=> sentence distance : 26
โ line 43
โ or
โ ๋๋
=> sentence distance : 2
โ line 44
โ client library package name as it appears to the developer, replacing slashes with dashes and removing the
โ ์ฌ๋์๋ฅผ ๋์๋ก ๋ฐ๊พธ๊ณ
=> sentence distance : 104
โ line 44
โ indicator. For example,
โ ํ์๊ธฐ๋ฅผ ์ ๊ฑฐํ์ฌ ๊ฐ๋ฐ์์๊ฒ ํ์๋๋ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ํจํค์ง ์ด๋ฆ. ์์:
=> sentence distance : 41
โ line 45
โ the version of the package. Note: this is not the version of the service
โ ํจํค์ง์ ๋ฒ์ . ์ฐธ๊ณ : ์๋น์ค ๋ฒ์ ์ด ์๋๋๋ค.
=> sentence distance : 65
โ line 46
โ information about the currently executing language runtime and OS, e.g.
โ ํ์ฌ ์คํ ์ค์ธ ์ธ์ด ๋ฐํ์ ๋ฐ OS์ ๋ํ ์ ๋ณด. ์์:
=> sentence distance : 62
โ line 48
โ For example, if we re-wrote `AzCopy` in each language using the
โ ์๋ฅผ ๋ค์ด,
=> sentence distance : 61
โ line 48
โ client library, we may end up with the following
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ์ฌ์ฉํ์ฌ ๊ฐ ์ธ์ด๋ก `AzCopy`๋ฅผ ๋ค์ ์์ฑํ๋ฉด, ๋ค์๊ณผ ๊ฐ์
=> sentence distance : 46
โ line 48
โ strings:
โ ๋ฌธ์์ด์ด ๋ฐ์ํ ์ ์์ต๋๋ค.
=> sentence distance : 16
โ line 55
โ allow the consumer of the library to set the application ID. This allows the consumer to obtain cross-service telemetry for their app. The application ID should be settable in the relevant
โ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์๋น์๊ฐ ์ ํ๋ฆฌ์ผ์ด์ ID๋ฅผ ์ค์ ํ ์ ์๋๋ก ํ์ฉํ์ญ์์ค. ์ด๋ฅผ ํตํด ์๋น์๋ ์ฑ์ ๋ํ ์๋น์ค ๊ฐ ์๊ฒฉ ๋ถ์์ ์ป์ ์ ์์ต๋๋ค. ์์ฉ ํ๋ก๊ทธ๋จ ID๋ ๊ด๋ จ
=> sentence distance : 166
โ line 55
โ object.
โ ๊ฐ์ฒด์์ ์ค์ ํ ์ ์์ด์ผ ํฉ๋๋ค.
=> sentence distance : 18
โ line 57
โ enforce that the application ID is no more than 24 characters in length. Shorter application IDs allows service teams to include diagnostic information in the "platform information" section of the user agent, while still allowing the consumer to obtain telemetry information for their own application.
โ ์ ํ๋ฆฌ์ผ์ด์ ID๊ฐ ๊ธธ์ด๋ 24์๋ฅผ ๋์ง ์๋๋ก ๊ฐ์ ํ์ญ์์ค. ์ ํ๋ฆฌ์ผ์ด์ ID๊ฐ ์งง์์๋ก ์๋น์ค ํ์ ์ฌ์ฉ์ ์์ด์ ํธ์ "ํ๋ซํผ ์ ๋ณด" ์น์ ์ ์ง๋จ ์ ๋ณด๋ฅผ ํฌํจ์ํฌ ์ ์์ผ๋ฉฐ, ์๋น์๋ ์ฌ์ ํ ์์ ์ ์ ํ๋ฆฌ์ผ์ด์ ์ ๋ํ ์๊ฒฉ ๋ถ์ ์ ๋ณด๋ฅผ ์ป์ ์ ์์ต๋๋ค.
=> sentence distance : 261
โ line 59
โ send telemetry information that is normally sent in the
โ ํ๋ซํผ์ด
=> sentence distance : 55
โ line 59
โ header in the
โ ํค๋ ๋ณ๊ฒฝ์ ์ง์ํ์ง ์์ ๊ฒฝ์ฐ, ์ผ๋ฐ์ ์ผ๋ก `User-Agent` ํค๋๋ก ์ ์กํ๋ ์๊ฒฉ ๋ถ์ ์ ๋ณด๋ฅผ
=> sentence distance : 52
โ line 59
โ header when the platform does not support changing the `User-Agent` header. Note that services will need to configure log gathering to capture the
โ ํค๋์ ๋ณด๋ด์ผ ํฉ๋๋ค. ์๋น์ค๋ ์ผ๋ฐ์ ์ธ ๋ถ์ ์์คํ ์ ํตํด ์ฟผ๋ฆฌํ ์ ์๋ ๋ฐฉ์์ผ๋ก
=> sentence distance : 135
โ line 59
โ header in such a way that it can be queried through normal analytics systems.
โ ํค๋๋ฅผ ์บก์ฒํ๋๋ก ๋ก๊ทธ ์์ง์ ๊ตฌ์ฑํด์ผ ํฉ๋๋ค.
=> sentence distance : 71
โ line 61
โ send additional (dynamic) telemetry information as a semi-colon separated set of key-value types in the
โ ์ถ๊ฐ์ ์ธ (๋์ ) ์๊ฒฉ ๋ถ์ ์ ๋ณด๋
=> sentence distance : 97
โ line 61
โ header. For example:
โ ํค๋์์ ํค-๊ฐ ์ ํ์ ์ธ๋ฏธ์ฝ๋ก ์ผ๋ก ๊ตฌ๋ถ๋ ์งํฉ์ผ๋ก ์ ์กํด์ผ ํฉ๋๋ค. ์๋ฅผ ๋ค์ด:
=> sentence distance : 41
โ line 67
โ The content of the header is a semi-colon key=value list. The following keys have specific meaning:
โ ํค๋์ ๋ด์ฉ์ ์ธ๋ฏธ์ฝ๋ก ํค=๊ฐ ๋ชฉ๋ก์ ๋๋ค. ๋ค์ ํค๋ ํน์ ํ ์๋ฏธ๋ฅผ ๊ฐ์ต๋๋ค:
=> sentence distance : 89
โ line 69
โ `class` is the name of the type within the client library that the consumer called to trigger the network operation.
โ `class`๋ ์๋น์๊ฐ ๋คํธ์ํฌ ์์ ์ ํธ๋ฆฌ๊ฑฐํ๊ธฐ ์ํด ํธ์ถํ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ๋ด ํ์ ์ ์ด๋ฆ์ ๋๋ค.
=> sentence distance : 97
โ line 70
โ `method` is the name of the method within the client library type that the consumer called to trigger the network operation.
โ `method`๋ ์๋น์๊ฐ ๋คํธ์ํฌ ์์ ์ ํธ๋ฆฌ๊ฑฐํ๊ธฐ ์ํด ํธ์ถํ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ๋ด ๋ฉ์๋์ ์ด๋ฆ์ ๋๋ค.
=> sentence distance : 104
โ line 72
โ Any other keys that are used should be common across all client libraries for a specific service. **DO NOT** include personally identifiable information (even encoded) in this header. Services need to configure log gathering to capture the
โ ์ฌ์ฉ๋๋ ๋ค๋ฅธ ๋ชจ๋ ํค๋ ํน์ ์๋น์ค์ ๋ชจ๋ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์์ ๊ณตํต์ ์ด์ด์ผ ํฉ๋๋ค. ์ด ํค๋์ (์ธ์ฝ๋ฉ๋ ๊ฒฝ์ฐ์๋) ๊ฐ์ธ ์๋ณ ์ ๋ณด๋ฅผ **ํฌํจํ์ง ๋ง์ญ์์ค**. ์๋น์ค๋ ์ผ๋ฐ์ ์ธ ๋ถ์ ์์คํ ์ ํตํด ์ฟผ๋ฆฌํ ์ ์๋ ๋ฐฉ์์ผ๋ก
=> sentence distance : 211
โ line 72
โ header in such a way that it can be queried through normal analytics systems.
โ ํค๋๋ฅผ ์บก์ฒํ๋๋ก ๋ก๊ทธ ์์ง์ ๊ตฌ์ฑํด์ผ ํฉ๋๋ค.
=> sentence distance : 71
โ line 74
โ Unique request
โ ๊ณ ์ ํ ์์ฒญ
=> sentence distance : 13
โ line 74
โ policy
โ ์ ์ฑ
=> sentence distance : 6
โ line 76
โ **TODO**
โ **TODO(์ถ๊ฐ ์์ )**
=> sentence distance : 7
โ line 78
โ Retry policy
โ ์ฌ์๋ ์ ์ฑ
=> sentence distance : 11
โ line 80
โ There are many reasons why failure can occur when a client application attempts to send a network request to a service. Some examples are timeout, network infrastructure failures, service rejecting the request due to throttle/busy, service instance terminating due to service scale-down, service instance going down to be replaced with another version, service crashing due to an unhandled exception, etc. By offering a built-in retry mechanism (with a default configuration the consumer can override), our SDKs and the consumer's application become resilient to these kinds of failures. Note that some services charge real money for each try and so consumers should be able to disable retries entirely if they prefer to save money over resiliency.
โ ํด๋ผ์ด์ธํธ ์ ํ๋ฆฌ์ผ์ด์ ์ด ์๋น์ค์ ๋คํธ์ํฌ ์์ฒญ์ ๋ณด๋ด๋ ค๊ณ ํ ๋ ์ค๋ฅ๊ฐ ๋ฐ์ํ๋ ๋ฐ์๋ ์ฌ๋ฌ ์ด์ ๊ฐ ์์ต๋๋ค. ๋ช ๊ฐ์ง ์๋ก๋ ์๊ฐ ์ด๊ณผ, ๋คํธ์ํฌ ์ธํ๋ผ ์ค๋ฅ, ์ ํ/์ฌ์ฉ ์ค์ผ๋ก ์ธํ ์๋น์ค ๊ฑฐ๋ถ, ์ค์ผ์ผ ๋ค์ด์ผ๋ก ์ธํ ์๋น์ค ์ธ์คํด์ค ์ข ๋ฃ, ๋ค๋ฅธ ๋ฒ์ ์ผ๋ก ๊ต์ฒดํ๊ธฐ ์ํด ๋ค์ด๋๋ ์๋น์ค ์ธ์คํด์ค, ์ฒ๋ฆฌ๋์ง ์์ ์์ธ๋ก ์ธํ ์๋น์ค ์ถฉ๋ ๋ฑ์ด ์์ต๋๋ค. ๊ธฐ๋ณธ ์ ๊ณต ์ฌ์๋ ๋ฉ์ปค๋์ฆ(์๋น์๊ฐ ์ฌ์ ์ํ ์ ์๋ ๊ธฐ๋ณธ ๊ตฌ์ฑ)์ ์ ๊ณตํจ์ผ๋ก์จ SDK์ ์๋น์ ์ ํ๋ฆฌ์ผ์ด์ ์ ์ด๋ฌํ ์ฅ์ ์ ํ๋ ฅ์ ์ผ๋ก ๋์ฒํ ์ ์์ต๋๋ค. ์ผ๋ถ ์๋น์ค๋ ๊ฐ ์๋์ ๋ํด ์ค์ ๋น์ฉ์ ์ฒญ๊ตฌํ๋ฏ๋ก, ์๋น์๊ฐ ๋ณต์๋ ฅ๋ณด๋ค ๋น์ฉ ์ ๊ฐ์ ์ ํธํ๋ ๊ฒฝ์ฐ ์ฌ์๋๋ฅผ ์์ ํ ๋นํ์ฑํํ ์ ์์ด์ผ ํฉ๋๋ค.
=> sentence distance : 653
โ line 82
โ For more information, see [Transient fault handling].
โ ๋ ๋ง์ ์ ๋ณด๋ ๋ค์์ ์ฐธ๊ณ ํ์ญ์์ค: [์ผ์์ ์ธ ์ค๋ฅ ์ฒ๋ฆฌ]
=> sentence distance : 46
โ line 84
โ Pipeline provides this functionality.
โ ํ์ดํ๋ผ์ธ์ ์ด ๊ธฐ๋ฅ์ ์ ๊ณตํฉ๋๋ค.
=> sentence distance : 33
โ line 86
โ offer the following configuration settings:
โ ๋ค์ ๊ตฌ์ฑ ์ค์ ์ ์ ๊ณตํ์ญ์์ค:
=> sentence distance : 39
โ line 88
โ Retry policy type (exponential or fixed)
โ ์ฌ์๋ ์ ์ฑ ์ ํ (์ง์ ๋๋ ๊ณ ์ )
=> sentence distance : 33
โ line 89
โ Maximum number of retries
โ ์ต๋ ์ฌ์๋ ํ์
=> sentence distance : 23
โ line 90
โ Delay between retries (timespan/duration; this is the delay for fixed policy, the delay is increased exponentially by this amount for the exponential policy)
โ ์ฌ์๋ ๊ฐ ์ง์ฐ(์๊ฐ ๊ฐ๊ฒฉ/๊ธฐ๊ฐ; ๊ณ ์ ์ ์ฑ ์ ๊ฒฝ์ฐ ์ด ์๋งํผ ์ง์ฐ, ์ง์ ์ ์ฑ ์ ๊ฒฝ์ฐ ์ง์ฐ์ด ์ด ์๋งํผ ๊ธฐํ๊ธ์์ ์ผ๋ก ์ฆ๊ฐํจ)
=> sentence distance : 136
โ line 91
โ Maximum retry delay (timespan/duration)
โ ์ต๋ ์ฌ์๋ ์ง์ฐ(์๊ฐ ๊ฐ๊ฒฉ/๊ธฐ๊ฐ)
=> sentence distance : 34
โ line 92
โ List of
โ ์ฌ์๋๋ฅผ ์ ๋ฐํ๋
=> sentence distance : 8
โ line 92
โ status codes that would cause a retry (default is "all service errors that are retryable")
โ ์ํ ์ฝ๋ ๋ชฉ๋ก(๊ธฐ๋ณธ๊ฐ์ "์ฌ์๋ ๊ฐ๋ฅํ ๋ชจ๋ ์๋น์ค ์ค๋ฅ")
=> sentence distance : 79
โ line 94
โ offer additional retry mechanisms if supported by the service. For example, the
โ ์๋น์ค์์ ์ง์ํ๋ ๊ฒฝ์ฐ ์ถ๊ฐ ์ฌ์๋ ๋ฉ์ปค๋์ฆ์ ์ ๊ณตํ ์ ์์ต๋๋ค. ์๋ฅผ ๋ค์ด
=> sentence distance : 71
โ line 94
โ service supports retrying read operations against a secondary datacenter, or recommends the use of a per-try timeout for resilience.
โ ์๋น์ค๋ ๋ณด์กฐ ๋ฐ์ดํฐ ์ผํฐ์ ๋ํ ์ฝ๊ธฐ ์์ ์ฌ์๋๋ฅผ ์ง์ํ๊ฑฐ๋, ๋ณต์๋ ฅ์ ์ํด ์๋๋น ์ ํ ์๊ฐ ์ฌ์ฉ์ ๊ถ์ฅํฉ๋๋ค.
=> sentence distance : 116
โ line 96
โ reset (or seek back to position 0) any request data stream before retrying a request
โ ์์ฒญ์ ์ฌ์๋ํ๊ธฐ ์ ์ ๋ชจ๋ ์์ฒญ ๋ฐ์ดํฐ ์คํธ๋ฆผ์ ์ฌ์ค์ (๋๋ ์์น 0์ผ๋ก ๋ค์ ํ์)ํ์ญ์์ค.
=> sentence distance : 74
โ line 98
โ honor any cancellation mechanism passed in to the caller which can terminate the request before retries have been attempted.
โ ์ฌ์๋๊ฐ ์คํ๋๊ธฐ ์ ์ ์์ฒญ์ ์ข ๋ฃํ ์ ์๋ ํธ์ถ์์๊ฒ ์ ๋ฌ๋ ์ทจ์ ๋ฉ์ปค๋์ฆ์ ์ค์ํ์ญ์์ค.
=> sentence distance : 112
โ line 100
โ update any query parameter or request header that gets sent to the service telling it how much time the service has to process the individual request attempt.
โ ์๋น์ค๊ฐ ๊ฐ๋ณ ์์ฒญ ์๋๋ฅผ ์ฒ๋ฆฌํด์ผ ํ๋ ๋ฐ ๊ฑธ๋ฆฌ๋ ์๊ฐ์ ์๋ ค์ฃผ๋ ์๋น์ค๋ก ์ ์ก๋๋ ์ฟผ๋ฆฌ ๋งค๊ฐ๋ณ์ ๋๋ ์์ฒญ ํค๋๋ฅผ ์ ๋ฐ์ดํธํ์ญ์์ค.
=> sentence distance : 140
โ line 102
โ retry in the case of a hardware network failure as it may self-correct.
โ ํ๋์จ์ด ๋คํธ์ํฌ ์ค๋ฅ์ ๊ฒฝ์ฐ ์์ฒด ์์ ๋ ์ ์์ผ๋ฏ๋ก ๋ค์ ์๋ํ์ญ์์ค.
=> sentence distance : 61
โ line 104
โ retry in the case of a "service not found" error. The service may be coming back online or a load balancer may be reconfiguring itself.
โ "์๋น์ค๋ฅผ ์ฐพ์ ์ ์์" ์ค๋ฅ๊ฐ ๋ฐ์ํ ๊ฒฝ์ฐ ๋ค์ ์๋ํ์ญ์์ค. ์๋น์ค๊ฐ ๋ค์ ์จ๋ผ์ธ ์ํ๊ฐ ๋๊ฑฐ๋ ๋ก๋ ๋ฐธ๋ฐ์๊ฐ ์์ฒด์ ์ผ๋ก ์ฌ๊ตฌ์ฑ ์ค์ผ ์ ์์ต๋๋ค.
=> sentence distance : 114
โ line 106
โ retry if the service successfully responds indicating that it is throttling requests (for example, with an
โ ์๋น์ค๊ฐ ์์ฒญ์ ์ ํํ๊ณ ์์์ ๋ํ๋ด๋ ์๋ต์ ์ฑ๊ณต์ ์ผ๋ก ์ํํ ๊ฒฝ์ฐ(์์,
=> sentence distance : 96
โ line 106
โ header or similar metadata).
โ ํค๋ ๋๋ ์ ์ฌํ ๋ฉํ๋ฐ์ดํฐ) ์ฌ์๋ํ์ญ์์ค.
=> sentence distance : 25
โ line 108
โ retry if the service responds with a 400-level response code unless a retry-after header is also returned.
โ ์๋น์ค๊ฐ 400 ์์ค ์๋ต ์ฝ๋๋ก ์๋ตํ๋ ๊ฒฝ์ฐ, Retry After ํค๋๊ฐ ๋ฐํ๋์ง ์๋ ํ ์ฌ์๋ํ์ง ๋ง์ญ์์ค.
=> sentence distance : 88
โ line 110
โ change any client-side generated request-id when retrying the request. Th request ID represents the logical operation and should be the same across all physical retries of this operation. When looking at server logs, multiple entries with the same client request ID show each retry
โ ์์ฒญ์ ์ฌ์๋ํ ๋ ํด๋ผ์ด์ธํธ ์ธก์์ ์์ฑํ ์์ฒญ ID๋ฅผ ๋ณ๊ฒฝํ์ง ๋ง์ญ์์ค. ์์ฒญ ID๋ ๋ ผ๋ฆฌ์ ์์ ์ ๋ํ๋ด๋ฉฐ, ์ด ์์ ์ ๋ชจ๋ ๋ฌผ๋ฆฌ์ ์ฌ์๋ ๋์ ๋์ผํด์ผ ํฉ๋๋ค. ์๋ฒ ๋ก๊ทธ๋ฅผ ๋ณผ ๋, ๋์ผํ ํด๋ผ์ด์ธํธ ์์ฒญ ID๋ฅผ ๊ฐ์ง ์ฌ๋ฌ ํญ๋ชฉ์ด ๊ฐ ์ฌ์๋๋ฅผ ํ์ํฉ๋๋ค.
=> sentence distance : 243
โ line 112
โ implement a default policy that starts at 3 retries with a 0.8s delay with exponential (plus jitter) backoff.
โ ์ง์(์งํฐ ํฌํจ) ๋ฐฑ์คํ์ ํจ๊ป 0.8์ด ์ง์ฐ์ผ๋ก 3ํ ์ฌ์๋์์ ์์ํ๋ ๊ธฐ๋ณธ ์ ์ฑ ์ ๊ตฌํํด์ผ ํฉ๋๋ค.
=> sentence distance : 96
โ line 114
โ Authentication policy
โ ์ธ์ฆ ์ ์ฑ
=> sentence distance : 20
โ line 116
โ use a variety of different authentication schemes to authenticate clients. Conceptually there are two entities responsible for authenticating service client requests, a credential and an authentication policy. Credentials provide confidential authentication data needed to authenticate requests. Authentication policies use the data provided by a credential to authenticate requests to the service. It is essential that credential data can be updated as needed across the lifetime of a client, and authentication policies must always use the most current credential data.
โ ์ ์ญ์ ์๋น์ค์์๋ ํด๋ผ์ด์ธํธ๋ฅผ ์ธ์ฆํ๊ธฐ ์ํด ๋ค์ํ ์ธ์ฆ ์คํค๋ง๋ฅผ ์ฌ์ฉํฉ๋๋ค. ๊ฐ๋ ์ ์ผ๋ก, ์๋น์ค ํด๋ผ์ด์ธํธ ์์ฒญ์ ์ธ์ฆํ๋ ๋ ๊ฐ์ง ์ํฐํฐ์ธ ์๊ฒฉ ์ฆ๋ช ๊ณผ ์ธ์ฆ ์ ์ฑ ์ด ์์ต๋๋ค. ์๊ฒฉ ์ฆ๋ช ์ ์์ฒญ์ ์ธ์ฆํ๋ ๋ฐ ํ์ํ ๊ธฐ๋ฐ ์ธ์ฆ ๋ฐ์ดํฐ๋ฅผ ์ ๊ณตํฉ๋๋ค. ์ธ์ฆ ์ ์ฑ ์ ์๋น์ค์ ๋ํ ์์ฒญ์ ์ธ์ฆํ๊ธฐ ์ํด ์๊ฒฉ ์ฆ๋ช ์ด ์ ๊ณตํ ๋ฐ์ดํฐ๋ฅผ ์ฌ์ฉํฉ๋๋ค. ํด๋ผ์ด์ธํธ ์๋ช ๊ธฐ๊ฐ ๋์ ์๊ฒฉ ์ฆ๋ช ๋ฐ์ดํฐ๋ ํ์์ ๋ฐ๋ผ ์ ๋ฐ์ดํธ๊ฐ ๊ฐ๋ฅํด์ผ ํ๋ฉฐ, ์ธ์ฆ ์ ์ฑ ์ ํญ์ ์ต์ ์๊ฒฉ ์ฆ๋ช ๋ฐ์ดํฐ๋ฅผ ์ฌ์ฉํด์ผ ํฉ๋๋ค.
=> sentence distance : 505
โ line 118
โ implement
โ (ํ ํฐ ์๊ฒฉ ์ฆ๋ช ๋ฐ ๋ฒ์๋ฅผ ํ์ฉํ๋)
=> sentence distance : 21
โ line 118
โ authorization policy (which accepts a token credential and
โ ๊ถํ ๋ถ์ฌ ์ ์ฑ ์ ๊ตฌํํ์ญ์์ค.
=> sentence distance : 55
โ line 121
โ Response downloader policy
โ ์๋ต ๋ค์ด๋ก๋(Response downloader) ์ ์ฑ
=> sentence distance : 15
โ line 123
โ The response downloader is required for most (but not all) operations to change whatever is returned by the service into a model that the consumer code can use. An example of a method that does not deserialize the response payload is a method that downloads a raw blob within the
โ ์๋น์ค๊ฐ ๋ฐํํ๋ ๋ชจ๋ ๊ฒ์ ์๋น์ ์ฝ๋๊ฐ ์ฌ์ฉํ ์ ์๋ ๋ชจ๋ธ๋ก ๋ณ๊ฒฝํ๊ธฐ ์ํด, ๋๋ถ๋ถ์(์ ๋ถ๋ ์๋) ์์ ์ ์๋ต ๋ค์ด๋ก๋๊ฐ ํ์ํฉ๋๋ค. ์๋ต ํ์ด๋ก๋๋ฅผ ์ญ์ง๋ ฌํํ์ง ์๋ ๋ฉ์๋์ ์๋ก,
=> sentence distance : 256
โ line 123
โ client library. In this case, the raw data bytes are required. For most operations, the body must be downloaded in totality before deserialization. This pipeline policy must implement the following requirements:
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ๋ด์์ ์์ Blob์ ๋ค์ด๋ก๋ํ๋ ๋ฉ์๋๊ฐ ์์ต๋๋ค. ์ด ๊ฒฝ์ฐ, ์์ ๋ฐ์ดํฐ ๋ฐ์ดํธ๊ฐ ํ์ํฉ๋๋ค. ๋๋ถ๋ถ์ ์์ ์์ ๋ณธ๋ฌธ์ ์ญ์ง๋ ฌํ ์ ์ ์ ์ฒด์ ์ผ๋ก ๋ค์ด๋ก๋๋์ด์ผ ํฉ๋๋ค. ์ด ํ์ดํ๋ผ์ธ ์ ์ฑ ์ ๋ค์ ์๊ตฌ ์ฌํญ์ ๊ตฌํํด์ผ ํฉ๋๋ค:
=> sentence distance : 185
โ line 125
โ download the entire response body and pass the complete downloaded body up to the operation method for methods that deserialize the response payload. If a network connection fails while reading the body, the retry policy must automatically retry the operation.
โ ์ ์ฒด ์๋ต ๋ณธ๋ฌธ์ ๋ค์ด๋ก๋ํ๊ณ , ์์ ํ ๋ค์ด๋ก๋ ๋ ์๋ต ๋ณธ๋ฌธ์ ์๋ต ํ์ด๋ก๋๋ฅผ ์ญ์ง๋ ฌํํ๋ ๋ฉ์๋์ ๋ํ ์์ ๋ฉ์๋์ ์ ๋ฌํ์ญ์์ค. ๋ณธ๋ฌธ์ ์ฝ๋ ๋์ ๋คํธ์ํฌ ์ฐ๊ฒฐ์ด ์คํจํ๋ฉด, ์ฌ์๋ ์ ์ฑ ์ด ์๋์ผ๋ก ์์ ์ ์ฌ์๋ํด์ผ ํฉ๋๋ค.
=> sentence distance : 230
โ line 127
โ Distributed tracing policy
โ ๋ถ์ฐ ์ถ์ ์ ์ฑ
=> sentence distance : 24
โ line 129
โ Distributed tracing allows the consumer to trace their code from frontend to backend. The distributed tracing library creates spans (units of unique work) to facilitate tracing. Each span is in a parent-child relationship. As you go deeper into the hierarchy of code, you create more spans. These spans can then be exported to a suitable receiver as needed. Spans must follow [Tracing Conventions]. To keep track of the spans, a _distributed tracing context_ (called a context within the rest of this section) is passed into each successive layer. For more information on this topic, visit the [OpenTelemetry] topic on tracing.
โ ๋ถ์ฐ ์ถ์ ๋ฉ์ปค๋์ฆ์ ํตํด ์๋น์๋ ๊ทธ๋ค์ ์ฝ๋๋ฅผ ํ๋ก ํธ์๋๋ถํฐ ๋ฐฑ์๋๊น์ง ์ถ์ ํ ์ ์์ต๋๋ค. ๋ถ์ฐ ์ถ์ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ ๊ณ ์ ํ ์์ ๋จ์์ธ ๋ฒ์๋ฅผ ์์ฑํฉ๋๋ค. ๊ฐ๊ฐ์ ๋ฒ์๋ ๋ถ๋ชจ-์์ ๊ด๊ณ์ ์์ต๋๋ค. ์ฝ๋ ๊ณ์ธต ๊ตฌ์กฐ์ ๋ ๊น์ด ๋ค์ด๊ฐ์๋ก ๋ ๋ง์ ๋ฒ์๊ฐ ์์ฑ๋ฉ๋๋ค. ์ด๋ฌํ ๋ฒ์๋ ํ์์ ๋ฐ๋ผ ์ ํฉํ ์์ ์๋ก ๋ด๋ณด๋ด์ง ์ ์์ต๋๋ค. ๋ฒ์๋ฅผ ์ถ์ ํ๊ธฐ ์ํด, _๋ถ์ฐ ์ถ์ ์ปจํ ์คํธ(์ดํ ์ปจํ ์คํธ)_๋ ๊ฐ ์ฐ์ ๊ณ์ธต์ผ๋ก ์ ๋ฌ๋ฉ๋๋ค. ์์ธํ ์ ๋ณด๋, [OpenTelemetry]์ ์ถ์ ํญ๋ชฉ์ ์ฐธ์กฐํ์ญ์์ค.
=> sentence distance : 550
โ line 131
โ The Distributed Tracing policy is responsible for:
โ ๋ถ์ฐ ์ถ์ ์ ์ฑ ์ ๋ค์ ์์ ์ ๋ด๋นํฉ๋๋ค:
=> sentence distance : 45
โ line 133
โ call.
โ ํธ์ถ๋น ๋ฒ์ ์์ฑ.
=> sentence distance : 9
โ line 133
โ Creating a SPAN per
โ None
=> sentence distance : None
โ line 134
โ Passing the context to the backend service.
โ ๋ฐฑ์๋ ์๋น์ค์ ์ปจํ ์คํธ ์ ๋ฌ.
=> sentence distance : 39
โ line 136
โ There is also a distributed tracing topic for implementing a client library.
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ๊ตฌํ ๋ฌธ์์๋ ๋ถ์ฐ ์ถ์ ๊ด๋ จ ์ฃผ์ ๊ฐ ์์ต๋๋ค.
=> sentence distance : 67
โ line 138
โ support [OpenTelemetry] for distributed tracing.
โ ๋ถ์ฐ ์ถ์ ์ ์ํด [OpenTelemetry]๋ฅผ ์ง์ํ์ญ์์ค.
=> sentence distance : 32
โ line 140
โ accept a context from calling code to establish a parent span.
โ ๋ถ๋ชจ ๋ฒ์๋ฅผ ์ค์ ํ๊ธฐ ์ํด ์ฝ๋ ํธ์ถ์์ ์ปจํ ์คํธ๋ฅผ ์๋ฝํ์ญ์์ค.
=> sentence distance : 55
โ line 142
โ pass the context to the backend service through the appropriate headers (`traceparent` and
โ [Azure Monitor]๋ฅผ ์ง์ํ๊ธฐ ์ํด ์ ์ ํ ํค๋(`traceparent`,
=> sentence distance : 65
โ line 142
โ per [W3C Trace-Context](https://www.w3.org/TR/trace-context/) standard) to support [Azure Monitor].
โ ๋ฑ)๋ฅผ ํตํด ๋ฐฑ์๋ ์๋น์ค์ ์ปจํ ์คํธ๋ฅผ ์ ๋ฌํ์ญ์์ค.
=> sentence distance : 93
โ line 144
โ create a new span (which must be a child of the per-method span) for each
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๊ฐ ์ํํ๋ ๊ฐ
=> sentence distance : 70
โ line 144
โ call that the client library makes.
โ ํธ์ถ์ ๋ํด ์ ๋ฒ์(๋ฉ์๋๋น ๋ฒ์์ ์์ ๋ฒ์์ด์ผ ํจ)๋ฅผ ๋ง๋์ญ์์ค.
=> sentence distance : 34
โ line 146
โ Logging policy
โ ๋ก๊น ์ ์ฑ
=> sentence distance : 13
โ line 148
โ mirror the same requirements for logging within the client library.
โ ๋ด์ ๋ง์ ๋ก๊น ์๊ตฌ ์ฌํญ์ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ๋ด์ ๋ก๊น ์ ๋ํ ๋์ผํ ์๊ตฌ ์ฌํญ์ ๋ฐ์ํฉ๋๋ค.
=> sentence distance : 58
โ line 150
โ allow the client library to set the log handler and log settings.
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๊ฐ ๋ก๊ทธ ํธ๋ค๋ฌ ๋ฐ ๋ก๊ทธ ์ค์ ์ ์ง์ ํ ์ ์๋๋ก ํ์ฉํ์ญ์์ค.
=> sentence distance : 55
โ line 152
โ use one of the following log levels when emitting logs: `Verbose` (details), `Informational` (things happened), `Warning` (might be a problem or not), and
โ ๋ก๊ทธ๋ฅผ ๋ด๋ณด๋ผ ๋๋ ๋ค์ ๋ก๊ทธ ๋ ๋ฒจ ์ค ํ๋๋ฅผ ์ฌ์ฉํ์ญ์์ค: `Verbose`(์์ธ ์ ๋ณด), `Informational`(๋ฐ์ํ ์ํฉ), `Warning`(๋ฌธ์ ์ผ ์ ์๋ ์ํฉ),
=> sentence distance : 96
โ line 154
โ logging level for failures that the application is unlikely to recover from (out of memory, etc.).
โ ๋ ๋ฒจ์ ์์ฉ ํ๋ก๊ทธ๋จ์ด ๋ณต๊ตฌ๋ ๊ฐ๋ฅ์ฑ์ด ๊ฑฐ์ ์๋ ์ค๋ฅ(๋ฉ๋ชจ๋ฆฌ ๋ถ์กฑ ๋ฑ)์ ์ฌ์ฉํ์ญ์์ค.
=> sentence distance : 87
โ line 154
โ use the
โ None
=> sentence distance : None
โ line 156
โ logging level when a function fails to perform its intended task. This generally means that the function will raise an exception. Don't include occurrences of self-healing events (for example, when a request will be automatically retried).
โ ๋ ๋ฒจ์ ํจ์๊ฐ ์๋ํ ์์ ์ ์ํํ์ง ๋ชปํ ๊ฒฝ์ฐ ์ฌ์ฉํ์ญ์์ค. ์ด๋ ์ผ๋ฐ์ ์ผ๋ก ํจ์๊ฐ ์์ธ๋ฅผ ๋ฐ์์ํจ๋ค๋ ๊ฒ์ ์๋ฏธํฉ๋๋ค. ์ค์ค๋ก ๋ณต๊ตฌํ๋ ์ด๋ฒคํธ ๋ฐ์(์๋ฅผ ๋ค์ด, ์์ฒญ์ด ์๋์ผ๋ก ์ฌ์๋๋๋ ๊ฒฝ์ฐ)์ ํฌํจํ์ง ๋ง์ญ์์ค.
=> sentence distance : 210
โ line 156
โ use the
โ None
=> sentence distance : None
โ line 158
โ logging level when a function operates normally.
โ ๋ ๋ฒจ์ ํจ์๊ฐ ์ ์์ ์ผ๋ก ์๋ํ ๋ ์ฌ์ฉํ์ญ์์ค.
=> sentence distance : 42
โ line 158
โ use the
โ None
=> sentence distance : None
โ line 160
โ logging level for detailed troubleshooting scenarios. This is primarily intended for developers or system administrators to diagnose specific failures.
โ ๋ ๋ฒจ์ ์์ธํ ๋ฌธ์ ํด๊ฒฐ ์๋๋ฆฌ์ค๋ฅผ ์ํด ์ฌ์ฉํ์ญ์์ค. ์ด๋ ์ฃผ๋ก ๊ฐ๋ฐ์ ํน์ ์์คํ ๊ด๋ฆฌ์๊ฐ ํน์ ์ค๋ฅ๋ฅผ ์ง๋จํ๊ธฐ ์ํ ๊ฒ์ ๋๋ค.
=> sentence distance : 133
โ line 160
โ use the
โ None
=> sentence distance : None
โ line 162
โ send sensitive information in log levels other than `Verbose`. For example, remove account keys when logging headers.
โ ์น์ธ๋ ํค๋์ ์ฟผ๋ฆฌ ํ๋ผ๋ฏธํฐ์ ์๋น์ค ์ ๊ณต "ํ์ฉ ๋ชฉ๋ก"์ ์๋ ํค๋ ๋ฐ ์ฟผ๋ฆฌ ํ๋ผ๋ฏธํฐ๋ง ๋ก๊ทธ๋ก ๊ธฐ๋กํ์ญ์์ค. ๋ค๋ฅธ ๋ชจ๋ ํค๋์ ์ฟผ๋ฆฌ ํ๋ผ๋ฏธํฐ๋ ํด๋น ๊ฐ์ ์์ ํด์ผ ํฉ๋๋ค.
=> sentence distance : 101
โ line 164
โ log request line, response line, and headers as an
โ ์์ฒญ ํ, ์๋ต ํ, ํค๋๋
=> sentence distance : 44
โ line 164
โ message.
โ ๋ก๊ทธ๋ฅผ ๋จ๊ธฐ์ญ์์ค.
=> sentence distance : 9
โ line 166
โ log an
โ ์๋น์ค ์์ฒญ์ด ์ทจ์๋ ๊ฒฝ์ฐ
=> sentence distance : 13
โ line 166
โ message if a service call is cancelled.
โ ๋ก๊ทธ๋ฅผ ๊ธฐ๋กํ์ญ์์ค.
=> sentence distance : 37
โ line 168
โ log exceptions thrown as a
โ ์์ธ๋
=> sentence distance : 26
โ line 168
โ level message. If the log level set to `Verbose`, append stack trace information to the message.
โ ๋ ๋ฒจ ๋ฉ์์ง๋ก ๊ธฐ๋กํ์ญ์์ค. ๋ก๊ทธ ๋ ๋ฒจ์ด `Verbose`๋ก ์ค์ ๋ ๊ฒฝ์ฐ, ์คํ ์ถ์ ์ ๋ณด๋ฅผ ๋ฉ์์ง์ ํฌํจํ์ญ์์ค.
=> sentence distance : 75
โ line 170
โ include information about relevant configuration when the
โ ๋ฌธ์ ๋ฅผ ์ํํ ์ ์๋ ๊ด๋ จ ๊ตฌ์ฑ ์ค์ ์ด ์๋ ๊ฒฝ์ฐ,
=> sentence distance : 51
โ line 170
โ pipeline throws an error if there is a relevant configuration setting that would alleviate the problem. Not all errors can be fixed with a configuration change.
โ ํ์ดํ๋ผ์ธ์ด ์ค๋ฅ๋ฅผ ๋ฐ์์ํฌ ๋ ๊ด๋ จ ๊ตฌ์ฑ ์ ๋ณด๋ฅผ ๋ก๊ทธ์ ํฌํจํ์ญ์์ค. ๋ชจ๋ ์ค๋ฅ๊ฐ ๊ตฌ์ฑ ๋ณ๊ฒฝ์ผ๋ก ํด๊ฒฐ๋ ์ ์๋ ๊ฒ์ ์๋๋๋ค.
=> sentence distance : 143
โ line 172
โ Proxy policy
โ ํ๋ก์ ์ ์ฑ
=> sentence distance : 11
โ line 174
โ SDK need to operate in common enterprises. It is a common practice to implement
โ SDK๋ฅผ ํตํฉํ๋ ์ฑ์ ์ผ๋ฐ ๊ธฐ์ ์์ ์ด์๋์ด์ผ ํฉ๋๋ค. ์ ์ด ๋ฐ ์บ์ฑ ๋ชฉ์ ์ผ๋ก
=> sentence distance : 68
โ line 174
โ proxies for control and caching purposes. Proxies are generally configured at the machine level and, as such, are part of the environment. However, there are reasons to adjust proxies (for example, testing may use a proxy to rewrite URLs to a test environment instead of a production environment). The
โ ํ๋ก์๋ฅผ ๊ตฌํํ๋ ๊ฒ์ด ์ผ๋ฐ์ ์ธ ๊ดํ์ ๋๋ค. ํ๋ก์๋ ์ผ๋ฐ์ ์ผ๋ก ๋จธ์ ์์ค์์ ๊ตฌ์ฑ๋๋ฉฐ, ๋ฐ๋ผ์ ํ๊ฒฝ์ ์ผ๋ถ์ ๋๋ค. ๊ทธ๋ฌ๋ ํ๋ก์๋ฅผ ์กฐ์ ํด์ผ ํ๋ ์ด์ ๊ฐ ์์ต๋๋ค(์๋ฅผ ๋ค์ด, ํ ์คํธ๋ URL ํ๋ก๋์ ํ๊ฒฝ ๋์ ํ ์คํธ ํ๊ฒฝ์ URL์ ๋ค์ ์์ฑํ๊ธฐ ์ํด ํ๋ก์๋ฅผ ์ฌ์ฉํ ์ ์์).
=> sentence distance : 261
โ line 174
โ SDK and all client libraries should operate in those environments.
โ SDK์ ๋ชจ๋ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ ํด๋น ํ๊ฒฝ์์ ์๋ํด์ผ ํฉ๋๋ค.
=> sentence distance : 55
โ line 176
โ There are a number of common methods for proxy configuration. However, they fall into four groups:
โ ํ๋ก์ ๊ตฌ์ฑ์๋ ์ฌ๋ฌ ๊ฐ์ง ์ผ๋ฐ์ ์ธ ๋ฐฉ๋ฒ์ด ์์ต๋๋ค. ๊ทธ๋ฌ๋ ๊ทธ๋ค์ ๋ค ๊ทธ๋ฃน์ผ๋ก ๋๋ฉ๋๋ค:
=> sentence distance : 86
โ line 178
โ Inline, no authentication (filtering only)
โ ์ธ๋ผ์ธ(Inline), ์ธ์ฆ ์์(ํํฐ๋ง๋ง ์ ์ฉ)
=> sentence distance : 35
โ line 179
โ Inline, with authentication
โ ์ธ๋ผ์ธ(Inline), ์ธ์ฆ ์์
=> sentence distance : 23
โ line 180
โ Out-of-band, no authentication
โ ๋์ญ ์ธ(Out-of-band), ์ธ์ฆ ์์
=> sentence distance : 22
โ line 181
โ Out of band, with authentication
โ ๋์ญ ์ธ(Out-of-band), ์ธ์ฆ ์์
=> sentence distance : 26
โ line 183
โ For inline/no-auth proxy, nothing needs to be done. The
โ ์ธ๋ผ์ธ/๋น์ธ์ฆ ํ๋ก์์ ๊ฒฝ์ฐ ์๋ฌด๊ฒ๋ ์ํํ ํ์๊ฐ ์์ต๋๋ค.
=> sentence distance : 49
โ line 183
โ SDK will work without any proxy configuration. For inline/auth proxy, the connection may receive a
โ SDK๋ ํ๋ก์ ๊ตฌ์ฑ ์์ด ์๋ํฉ๋๋ค. ์ธ๋ผ์ธ/์ธ์ฆ ํ๋ก์์ ๊ฒฝ์ฐ, ์ฐ๊ฒฐ์
=> sentence distance : 86
โ line 183
โ status code. This will include a scheme, realm, and potentially other information (such as a `nonce` for digest authentication). The client library must resubmit the request with a
โ ์ํ ์ฝ๋๊ฐ ์์ ๋ ์ ์์ต๋๋ค. ์ฌ๊ธฐ์๋ ์คํค๋ง, ์์ญ ๋ฐ ์ ์ฌ์ ์ธ ๋ค๋ฅธ ์ ๋ณด(์์: Digest ์ธ์ฆ์ ์ํ `nonce`)๊ฐ ํฌํจ๋ฉ๋๋ค. ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ ์คํค๋ง์ ์ ํฉํ๊ฒ ์ธ์ฝ๋ฉ๋ ์ธ์ฆ ์ ๋ณด๋ฅผ ์ ๊ณตํ๋
=> sentence distance : 152
โ line 183
โ header that provides authentication information suitably encoded for the scheme. The most common schemes are
โ ํค๋๋ฅผ ์ฌ์ฉํ์ฌ ์์ฒญ์ ๋ค์ ์ ์ถํด์ผ ํฉ๋๋ค. ๊ฐ์ฅ ์ผ๋ฐ์ ์ธ ์คํค๋ง๋
=> sentence distance : 100
โ line 183
โ and NTLM.
โ ๊ทธ๋ฆฌ๊ณ NTLM์ ๋๋ค.
=> sentence distance : 6
โ line 185
โ For an out-of-band/no-auth proxy, the client will send the entire request URL to the proxy instead of the service. For example, if the client is communicating to `https://foo.blob.storage.azure.net/path/to/blob`, it will connect to the `HTTPS_PROXY` and send a
โ ๋์ญ ์ธ/์ธ์ฆ ์์ ํ๋ก์์ ๊ฒฝ์ฐ, ํด๋ผ์ด์ธํธ๋ ์ ์ฒด ์์ฒญ URL์ ์๋น์ค ๋์ ํ๋ก์๋ก ๋ณด๋ ๋๋ค. ์๋ฅผ ๋ค์ด, ํด๋ผ์ด์ธํธ๊ฐ `https://foo.blob.storage.azure.net/path/to/blob` ์ ํต์ ํ๋ ๊ฒฝ์ฐ, ํด๋ผ์ด์ธํธ๋ `HTTPS_PROXY`์ ์ฐ๊ฒฐํ์ฌ
=> sentence distance : 171
โ line 185
โ HTTP/1.1`. For an out-of-band/auth proxy, the client will send the entire request URL just as in the out-of-band/no-auth proxy version, but it may send back a
โ HTTP/1.1` ์์ฒญ์ ๋ณด๋ ๋๋ค. ๋์ญ ์ธ/์ธ์ฆ ํ๋ก์์ ๊ฒฝ์ฐ, ํด๋ผ์ด์ธํธ๋ ๋์ญ ์ธ/์ธ์ฆ ์์ ํ๋ก์ ๋ฒ์ ์ฒ๋ผ ์ ์ฒด ์์ฒญ URL์ ๋ณด๋ด์ง๋ง, (์ธ๋ผ์ธ/์ธ์ฆ ํ๋ก์์ ๋ง์ฐฌ๊ฐ์ง๋ก)
=> sentence distance : 132
โ line 185
โ status code (as with the inline/auth proxy).
โ ์ํ ์ฝ๋๋ฅผ ๋ค์ ๋ณด๋ผ ์ ์์ต๋๋ค.
=> sentence distance : 38
โ line 187
โ WebSockets can normally be tunneled through an
โ WebSocket์ ์ผ๋ฐ์ ์ผ๋ก
=> sentence distance : 36
โ line 187
โ proxy, in which case the proxy authentication happens during the
โ ํ๋ก์๋ฅผ ํตํด ํฐ๋๋ง๋ ์ ์์ผ๋ฉฐ, ์ด ๊ฒฝ์ฐ ํ๋ก์ ์ธ์ฆ์
=> sentence distance : 56
โ line 187
โ call. This is the preferred mechanism for tunneling non-HTTP traffic to the
โ ํธ์ถ ์ค์ ๋ฐ์ํฉ๋๋ค. ์ด๋ ๋น HTTP ํธ๋ํฝ์
=> sentence distance : 66
โ line 187
โ service. However, there are other types of proxies. The most notable is the
โ ์๋น์ค๋ก ํฐ๋๋งํ๊ธฐ ์ํด ์์ฃผ ์ฌ์ฉ๋๋ ๋ฉ์ปค๋์ฆ์ ๋๋ค. ํํธ, ๋ค๋ฅธ ์ ํ์ ํ๋ก์๊ฐ ์์ต๋๋ค. ๊ฐ์ฅ ์ฃผ๋ชฉํ ๋งํ ๊ฒ์ ๋น HTTP ํธ๋ํฝ(AMQP ๋๋ MQTT ๋ฑ)์ ์ฌ์ฉ๋๋
=> sentence distance : 84
โ line 187
โ proxy used for non-HTTP traffic (such as AMQP or MQTT). We make no recommendation (for or against) support of SOCKS. It is explicitly not a requirement to support
โ ํ๋ก์์ ๋๋ค. SOCKS์ ๋ํ ์ง์์ ์ถ์ฒํ์ง๋, ๋ฐ๋ํ์ง๋ ์์ต๋๋ค. ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ๋ด์์
=> sentence distance : 152
โ line 187
โ proxy within the client library.
โ ํ๋ก์๋ฅผ ์ง์ํ๋ ๊ฒ์ ๋ช ์์ ์ผ๋ก ์๊ตฌ ์ฌํญ์ด ์๋๋๋ค.
=> sentence distance : 30
โ line 189
โ Most proxy configuration will be done by adopting the
โ ๋๋ถ๋ถ์ ํ๋ก์ ๊ตฌ์ฑ์ ๋ชจ๋ Azure ์๋น์ค ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ๊ณตํต์ ์ธ
=> sentence distance : 48
โ line 189
โ pipeline that is common to all Azure service client libraries.
โ ํ์ดํ๋ผ์ธ์ ์ฑํํ์ฌ ์ํ๋ฉ๋๋ค.
=> sentence distance : 59
โ line 191
โ support proxy configuration via common global configuration directives configured on a platform or runtime basis.
โ ํ๋ซํผ ๋๋ ๋ฐํ์ ๊ธฐ๋ฐ์ผ๋ก ๊ตฌ์ฑ๋ ๊ณตํต ๊ธ๋ก๋ฒ ๊ตฌ์ฑ ์ง์๋ฌธ์ ํตํด ํ๋ก์ ๊ตฌ์ฑ์ ์ง์ํ์ญ์์ค.
=> sentence distance : 101
โ line 193
โ and macOS generally use the `HTTPS_PROXY` (and associated) environment variables to configure proxies.
โ ๋ฐ macOS๋ ์ผ๋ฐ์ ์ผ๋ก `HTTPS_PROXY`(๋ฐ ๊ด๋ จ๋) ํ๊ฒฝ ๋ณ์๋ฅผ ์ฌ์ฉํ์ฌ ํ๋ก์๋ฅผ ๊ตฌ์ฑํฉ๋๋ค.
=> sentence distance : 73
โ line 194
โ environments generally use the
โ ํ๊ฒฝ์ ์ผ๋ฐ์ ์ผ๋ก
=> sentence distance : 29
โ line 194
โ proxy configuration to configure proxies.
โ ํ๋ก์ ๊ตฌ์ฑ์ ์ฌ์ฉํ์ฌ ํ๋ก์๋ฅผ ๊ตฌ์ฑํฉ๋๋ค.
=> sentence distance : 37
โ line 195
โ Other options (such as loading from configuration files) may exist on a platform and runtime basis.
โ ๋ค๋ฅธ ์ต์ (์๋ฅผ ๋ค์ด, ๊ตฌ์ฑ ํ์ผ์์ ๋ก๋)์ ํ๋ซํผ ๋ฐ ๋ฐํ์ ๊ธฐ๋ฐ์ผ๋ก ์กด์ฌํ ์ ์์ต๋๋ค.
=> sentence distance : 85
โ line 197
โ support
โ ํ๋ก์ ๊ธฐ๋ฅ ๋นํ์ฑํ๋ฅผ ํฌํจํ ํ๋ก์ ๊ตฌ์ฑ์ ๋ํ
=> sentence distance : 27
โ line 197
โ SDK-wide configuration directives for proxy configuration, including disabling the proxy functionality.
โ SDK ์ ์ฒด ๊ตฌ์ฑ ์ง์๋ฌธ์ ์ง์ํ์ญ์์ค.
=> sentence distance : 95
โ line 199
โ support client library-specific configuration directives for proxy configuration, including disabling the proxy functionality.
โ ํ๋ก์ ๊ธฐ๋ฅ ๋นํ์ฑํ๋ฅผ ํฌํจํ ํ๋ก์ ๊ตฌ์ฑ์ ๋ํ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ณ ๊ตฌ์ฑ ์ง์๋ฌธ์ ์ง์ํ์ญ์์ค.
=> sentence distance : 114
โ line 201
โ requests and responses.
โ ์์ฒญ ๋ฐ ์๋ต ๋ก๊ทธ๋ฅผ ๋จ๊ธฐ์ญ์์ค.
=> sentence distance : 20
โ line 201
โ log
โ None
=> sentence distance : None
โ line 203
โ indicate in logging if the request is being sent to the service via a proxy, even if proxy authentication is not required.
โ ํ๋ก์ ์ธ์ฆ์ด ํ์ํ์ง ์๋๋ผ๋, ํ๋ก์๋ฅผ ํตํด ์์ฒญ์ด ์๋น์ค๋ก ์ ์ก๋๊ณ ์๋ ๊ฒฝ์ฐ ๋ก๊น ์ ํ์ํ์ญ์์ค.
=> sentence distance : 109
โ line 205
โ and
โ ๋ฐ
=> sentence distance : 3
โ line 205
โ authentication schemes.
โ ์ธ์ฆ ์คํค๋ง๋ฅผ ์ง์ํ์ญ์์ค.
=> sentence distance : 21
โ line 205
โ support
โ None
=> sentence distance : None
โ line 207
โ authentication scheme.
โ ์ธ์ฆ ์ฒด๊ณ๋ฅผ ์ง์ํด์ผ ํฉ๋๋ค.
=> sentence distance : 20
โ line 207
โ support the
โ None
=> sentence distance : None
โ line 209
โ There is no requirement to support SOCKS at this time. We recommend services adopt a
โ ํ์ฌ SOCKS๋ฅผ ์ง์ํด์ผ ํ๋ ์๊ตฌ ์ฌํญ์ ์์ต๋๋ค. ํ๋ก์์์ ํธํ์ฑ์ ๋ณด์ฅํ๊ธฐ ์ํด ์๋น์ค์์
=> sentence distance : 75
โ line 209
โ connectivity option (for example,
โ ์ฐ๊ฒฐ ์ต์ (์๋ฅผ ๋ค์ด, WebSocket์ ํตํ
=> sentence distance : 30
โ line 209
โ or MQTT over WebSockets) to ensure compatibility with proxies.
โ ๋๋ MQTT)์ ์ฑํํ๋ ๊ฒ์ด ์ข์ต๋๋ค.
=> sentence distance : 52
โ line 211
โ Global configuration
โ ์ ์ญ ๊ตฌ์ฑ
=> sentence distance : 19
โ line 213
โ SDK can be configured by a variety of sources, some of which are necessarily language-dependent. This will generally be codified in the
โ SDK๋ ๋ค์ํ ์์ค๋ก ๊ตฌ์ฑํ ์ ์์ผ๋ฉฐ, ๊ทธ ์ค ์ผ๋ถ๋ ๋ฐ๋์ ์ธ์ด์ ๋ฐ๋ผ ๋ค๋ฆ ๋๋ค. ์ด๊ฒ์ ์ผ๋ฐ์ ์ผ๋ก
=> sentence distance : 118
โ line 213
โ library. The configuration sources include:
โ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์์ ์ฝ๋ํ๋ฉ๋๋ค. ๊ตฌ์ฑ ์์ค๋ ๋ค์๊ณผ ๊ฐ์ต๋๋ค:
=> sentence distance : 40
โ line 215
โ System settings
โ ์์คํ ์ค์
=> sentence distance : 14
โ line 216
โ Environment variables
โ ํ๊ฒฝ ๋ณ์
=> sentence distance : 20
โ line 217
โ Global configuration store (code)
โ ์ ์ญ ๊ตฌ์ฑ ์ ์ฅ์(์ฝ๋)
=> sentence distance : 29
โ line 218
โ Runtime parameters
โ ๋ฐํ์ ๋งค๊ฐ ๋ณ์
=> sentence distance : 17
โ line 220
โ apply configuration in the order above by default, such that subsequent items in the list override settings from previous items in the list.
โ ๊ธฐ๋ณธ์ ์ผ๋ก ์์ ์์๋๋ก ๊ตฌ์ฑ์ ์ ์ฉํ์ฌ, ๋ชฉ๋ก์ ํ์ ํญ๋ชฉ์ด ์ด์ ํญ๋ชฉ์ ์ค์ ์ ์ฌ์ ์ํ๋๋ก ํ์ญ์์ค.
=> sentence distance : 126
โ line 222
โ support configuration systems that users opt in to that do not follow the above ordering.
โ ์ฌ์ฉ์๊ฐ ์์ ์์๋ฅผ ๋ฐ๋ฅด์ง ์๋ ๊ตฌ์ฑ ์์คํ ์ ์ง์ํ ์ ์์ต๋๋ค.
=> sentence distance : 79
โ line 224
โ be consistent with naming between environment variables and configuration keys.
โ ํ๊ฒฝ ๋ณ์์ ๊ตฌ์ฑ ํค ์ฌ์ด์ ์ด๋ฆ์ ์ผ๊ด๋๊ฒ ์ง์ ํ์ญ์์ค.
=> sentence distance : 71
โ line 226
โ log when a configuration setting is found somewhere in the environment or global configuration store.
โ ํ๊ฒฝ ๋๋ ์ ์ญ ๊ตฌ์ฑ ์ ์ฅ์์ ์ด๋๊ฐ์์ ๊ตฌ์ฑ ์ค์ ์ด ๋ฐ๊ฒฌ๋๋ฉด ๋ก๊ทธ๋ก ๋จ๊ธฐ์ญ์์ค.
=> sentence distance : 90
โ line 228
โ ignore configuration settings that are irrelevant for your client library.
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ๋ฌด๊ดํ ๊ตฌ์ฑ ์ค์ ์ ๋ฌด์ํ ์ ์์ต๋๋ค.
=> sentence distance : 66
โ line 230
โ System settings
โ ์์คํ ์ค์
=> sentence distance : 14
โ line 232
โ respect system settings for proxies.
โ ํ๋ก์์ ๋ํ ์์คํ ์ค์ ์ ์ค์ํด์ผ ํฉ๋๋ค.
=> sentence distance : 32
โ line 234
โ Environment variables
โ ํ๊ฒฝ ๋ณ์
=> sentence distance : 20
โ line 236
โ Environment variables are a well-known method for
โ ํ๊ฒฝ ๋ณ์๋
=> sentence distance : 48
โ line 236
โ administrators to configure basic settings when running code in the cloud.
โ ๊ด๋ฆฌ์๊ฐ ํด๋ผ์ฐ๋์์ ์ฝ๋๋ฅผ ์คํํ ๋ ๊ธฐ๋ณธ ์ค์ ์ ๊ตฌ์ฑํ ์ ์๋ ์ ์๋ ค์ง ๋ฐฉ๋ฒ์ ๋๋ค.
=> sentence distance : 64
โ line 238
โ load relevant configuration settings from the environment variables listed in the table below:
โ ์๋ ํ์ ๋์ด๋ ํ๊ฒฝ ๋ณ์์์ ๊ด๋ จ ๊ตฌ์ฑ ์ค์ ์ ๋ก๋ํ์ญ์์ค:
=> sentence distance : 85
โ line 242
โ prefix Azure-specific environment variables with `AZURE_`.
โ Azure ํน์ ํ๊ฒฝ ๋ณ์์ ์ ๋์ฌ๋ฅผ `AZURE_`๋ก ์ง์ ํ์ญ์์ค.
=> sentence distance : 48
โ line 244
โ ### Global configuration
โ {% include requirement/MUST id="azurecore-config-envvars-no-proxy-cidr" %} `NO_PROXY`์ ๋ํด [CIDR notation]๋ฅผ ์ง์ํ์ญ์์ค.
=> sentence distance : 100
โ line 246
โ Global configuration refers to configuration settings that are applied to all applicable client constructors in some manner.
โ ### ์ ์ญ ๊ตฌ์ฑ
=> sentence distance : 122
โ line 248
โ {% include requirement/MUST id="azurecore-config-shared-pipeline-policies" %} support global configuration of shared pipeline policies including:
โ ์ ์ญ ๊ตฌ์ฑ์ ์ด๋ค ๋ฐฉ์์ผ๋ก๋ ์ ์ฉ ๊ฐ๋ฅํ ๋ชจ๋ ํด๋ผ์ด์ธํธ ์์ฑ์์ ์ ์ฉ๋๋ ๊ตฌ์ฑ ์ค์ ์ ๋ํ๋ ๋๋ค.
=> sentence distance : 134
โ line 250
โ * Logging: Log level, swapping out logger implementation
โ {% include requirement/MUST id="azurecore-config-shared-pipeline-policies" %} ๋ค์์ ํฌํจํ ๊ณต์ ํ์ดํ๋ผ์ธ ์ ์ฑ ์ ์ ์ญ ๊ตฌ์ฑ์ ์ง์ํ์ญ์์ค:
=> sentence distance : 98
โ line 255
โ None
โ * ๋ก๊น : ๋ก๊ทธ ๋ ๋ฒจ, ๋ก๊ฑฐ ๊ตฌํ ๊ต์ฒด(swapping out)
=> sentence distance : None
โ line 256
โ None
โ * HTTP: ํ๋ก์ ์ค์ , ์ต๋ ์ฌ์๋ ํ์, ์๊ฐ ์ด๊ณผ, ์ ์ก ๊ตฌํ ๊ต์ฒด(swapping out)
=> sentence distance : None
โ line 257
โ None
โ * ์๊ฒฉ ๋ถ์: ํ์ฑํ/๋นํ์ฑํ
=> sentence distance : None
โ line 258
โ {% include requirement/MUST id="azurecore-config-override-global-config" %} provide configuration keys for setting or overriding every configuration setting inherited from the system or environment variables.
โ * ์ถ์ : ํ์ฑํ/๋นํ์ฑํ
=> sentence distance : 205
โ line 260
โ id="azurecore-config-opt-out"
โ id="azurecore-config-override-global-config"
=> sentence distance : 19
โ line 260
โ provide a method of opting out from importing system settings and environment variables into the configuration.
โ ์์คํ ๋๋ ํ๊ฒฝ ๋ณ์์์ ์์๋ ๋ชจ๋ ๊ตฌ์ฑ ์ค์ ์ ์ค์ ํ๊ฑฐ๋ ์ฌ์ ์ํ๊ธฐ ์ํ ๊ตฌ์ฑ ํค๋ฅผ ์ ๊ณตํ์ญ์์ค.
=> sentence distance : 97
โ line 262
โ ## Authentication and credentials
โ {% include requirement/MUST id="azurecore-config-opt-out" %} ์์คํ ์ค์ ๋ฐ ํ๊ฒฝ ๋ณ์๋ฅผ ๊ตฌ์ฑ์ผ๋ก ๊ฐ์ ธ์ค๋ ๊ฒ์ ๊ฑฐ๋ถํ๋ ๋ฐฉ๋ฒ์ ์ ๊ณตํ์ญ์์ค.
=> sentence distance : 94
โ line 264
โ OAuth token authentication, obtained via Managed Security Identities (MSI) or Azure Identity is the preferred mechanism for authenticating service requests, and the only authentication credentials supported by the Azure Core library.
โ ## ์ธ์ฆ ๋ฐ ์๊ฒฉ ์ฆ๋ช
=> sentence distance : 229
โ line 266
โ provide a token credential type that can fetch an OAuth-compatible token needed to authenticate a request to the service in a non-blocking atomic manner.
โ MSI(Managed Security Identity) ๋๋ Azure Identity๋ฅผ ํตํด ์ป๋ OAuth ํ ํฐ ์ธ์ฆ์ ์๋น์ค ์์ฒญ์ ์ธ์ฆํ๋ ๊ธฐ๋ณธ ๋ฉ์ปค๋์ฆ์ด๋ฉฐ, Azure Core ๋ผ์ด๋ธ๋ฌ๋ฆฌ์์ ์ง์ํ๋ ์ ์ผํ ์ธ์ฆ ์๊ฒฉ ์ฆ๋ช ์ ๋๋ค.-]{% include requirement/MUST id="azurecore-auth-token-credential" %} [-์๋น์ค์ ๋ํ ์์ฒญ์ ๋น์ฐจ๋จ ์์์ฑ ๋ฐฉ์์ผ๋ก ์ธ์ฆํ๋ ๋ฐ ํ์ํ OAuth ํธํ ํ ํฐ์ ๊ฐ์ ธ์ฌ ์ ์๋ ํ ํฐ ์๊ฒฉ ์ฆ๋ช ์ ํ์ ์ ๊ณตํ์ญ์์ค.
=> sentence distance : 232
โ line 266
โ None
โ MSI(Managed Security Identity) ๋๋ Azure Identity๋ฅผ ํตํด ์ป๋ OAuth ํ ํฐ ์ธ์ฆ์ ์๋น์ค ์์ฒญ์ ์ธ์ฆํ๋ ๊ธฐ๋ณธ ๋ฉ์ปค๋์ฆ์ด๋ฉฐ, Azure Core ๋ผ์ด๋ธ๋ฌ๋ฆฌ์์ ์ง์ํ๋ ์ ์ผํ ์ธ์ฆ ์๊ฒฉ ์ฆ๋ช ์ ๋๋ค.
=> sentence distance : None
โ line 270
โ header]:
โ ํค๋]:
=> sentence distance : 6
โ line 271
โ [Transient fault handling]:
โ [์ผ์์ ์ธ ์ค๋ฅ ์ฒ๋ฆฌ]:
=> sentence distance : 22
โ line 274
โ [Tracing Conventions]: {{ site.baseurl }}{% link docs/tracing/distributed-tracing-conventions.md %}
โ [CIDR notation]: https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing
=> sentence distance : 75
2396 words added. 1874 words deleted.
Added words rate 102.17484008528785% (2396 / 2345 words)
Deleted words rate 79.91471215351812% (1874 / 2345 words)
-
design.md : File Modified +4120 / -3117 ๐ 3808
โ line 2
โ "General Guidelines:
โ "๊ณตํต ๊ฐ์ด๋๋ผ์ธ:
=> sentence distance : 17
โ line 2
โ Design"
โ ๋์์ธ"
=> sentence distance : 6
โ line 9
โ The
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์
=> sentence distance : 12
โ line 9
โ surface of your client library must have the most thought as it is the primary interaction that the consumer has with your service.
โ ํ๋ฉด์ ์๋น์๊ฐ ์๋น์ค์ ๊ฐ๋ ์ฃผ์ ์ํธ ์์ฉ์ด๊ธฐ ๋๋ฌธ์ ๊ฐ์ฅ ๋ง์ด ๊ณ ๋ คํด์ผ ํฉ๋๋ค.
=> sentence distance : 119
โ line 11
โ Namespaces
โ ๋ค์์คํ์ด์ค
=> sentence distance : 10
โ line 13
โ Some languages have a concept of namespaces to group related types. Grouping services within a cloud infrastructure is common since it aids discoverability and provides structure to the reference documentation.
โ ์ผ๋ถ ์ธ์ด์๋ ๊ด๋ จ ์ ํ์ ๊ทธ๋ฃนํํ๊ธฐ ์ํ ๋ค์์คํ์ด์ค ๊ฐ๋ ์ด ์์ต๋๋ค. ํด๋ผ์ฐ๋ ์ธํ๋ผ ๋ด์์ ์๋น์ค๋ฅผ ๊ทธ๋ฃนํํ๋ ๊ฒ์ ๊ฒ์ ๊ฐ๋ฅ์ฑ์ ์ง์ํ๊ณ ์ฐธ์กฐ ๋ฌธ์์ ๊ตฌ์กฐ๋ฅผ ์ ๊ณตํ๊ธฐ ๋๋ฌธ์ ์ผ๋ฐ์ ์ ๋๋ค.
=> sentence distance : 187
โ line 15
โ support namespaces if namespace usage is common within the language ecosystem.
โ ์ธ์ด ์ํ๊ณ์์ ๋ค์์คํ์ด์ค ์ฌ์ฉ์ด ์ผ๋ฐ์ ์ธ ๊ฒฝ์ฐ ๋ค์์คํ์ด์ค๋ฅผ ์ง์ํด์ผ ํฉ๋๋ค.
=> sentence distance : 70
โ line 17
โ use a root namespace of the form `. . `. All consumer-facing APIs that are commonly used should exist within this namespace. The namespace is comprised of three parts:
โ `. . ` ํ์์ ๋ฃจํธ ๋ค์์คํ์ด์ค๋ฅผ ์ฌ์ฉํ์ญ์์ค. ์ผ๋ฐ์ ์ผ๋ก ์ฌ์ฉ๋๋ ๋ชจ๋ ์๋น์ ๋๋ฉด API๋ ์ด ๋ค์์คํ์ด์ค ๋ด์ ์์ด์ผ ํฉ๋๋ค. ๋ค์์คํ์ด์ค๋ ์ธ ๋ถ๋ถ์ผ๋ก ๊ตฌ์ฑ๋ฉ๋๋ค:
=> sentence distance : 146
โ line 19
โ `` indicates a common prefix for all
โ ``๋ ๋ชจ๋
=> sentence distance : 33
โ line 19
โ services. This may be
โ ์๋น์ค์ ๋ํ ๊ณตํต ์ ๋์ฌ๋ฅผ ๋ํ๋ ๋๋ค. ์ด๋ ์ธ์ด ๋ด ๊ณตํต ํ์์ ๋ฐ๋ผ
=> sentence distance : 35
โ line 19
โ or `com.azure` or similiar, depending on the common form within the language.
โ ๋๋ `com.azure`์ด๊ฑฐ๋ ์ด์ ์ ์ฌํ ์ ์์ต๋๋ค.
=> sentence distance : 60
โ line 20
โ `` is the group for the service. See the list below.
โ ``์ ์๋น์ค์ ๊ทธ๋ฃน์ ๋๋ค. ์๋์ ๋ฆฌ์คํธ๋ฅผ ๋ณด์ญ์์ค.
=> sentence distance : 44
โ line 21
โ `` is the shortened service name.
โ ``๋ ์ค์ฌ ์ด ์๋น์ค ์ด๋ฆ์ ๋๋ค.
=> sentence distance : 27
โ line 23
โ pick a shortened service name that allows the consumer to tie the package to the service being used. As a default, use the compressed service name. The namespace does **NOT** change when the branding of the product changes, so avoid the use of marketing names that may change.
โ ์๋น์๊ฐ ํจํค์ง๋ฅผ ์ฌ์ฉ ์ค์ธ ์๋น์ค์ ์ฐ๊ฒฐํ ์ ์๋๋ก ๋จ์ถ๋ ์๋น์ค ์ด๋ฆ์ ์ ํํ์ญ์์ค. ๊ธฐ๋ณธ์ ์ผ๋ก, ์ค์ฌ์ ์ด ์๋น์ค ์ด๋ฆ์ ์ฌ์ฉํฉ๋๋ค. ๋ค์์คํ์ด์ค๋ ์ ํ ๋ธ๋๋ฉ์ด ๋ณ๊ฒฝ๋ ๋ ๋ณ๊ฒฝ๋์ง **์์ต๋๋ค**. ๋ฐ๋ผ์ ๋ณ๊ฒฝ๋ ์ ์๋ ๋ง์ผํ ์ด๋ฆ์ ์ฌ์ฉ์ ํผํ์ธ์.
=> sentence distance : 243
โ line 25
โ A compressed service name is the service name without spaces. It may further be shortened if the shortened version is well known in the community. For example,
โ ์ค์ฌ ์ด ์๋น์ค ์ด๋ฆ์ ๊ณต๋ฐฑ์ด ์๋ ์๋น์ค ์ด๋ฆ์ ๋๋ค. ์ปค๋ฎค๋ํฐ์์ ์ค์ฌ ์ด ์ด๋ฆ์ด ์ ์๋ ค์ง ๊ฒฝ์ฐ, ๋ ์ค์ฌ ์ธ ์ ์์ต๋๋ค. ์๋ฅผ ๋ค์ด,
=> sentence distance : 137
โ line 25
โ Analytics" would have a compressed service name of `MediaAnalytics`, whereas
โ Analytics"๋ ์ค์ฌ ์ด ์๋น์ค ์ด๋ฆ์ด `MediaAnalytics`์ธ ํํธ,
=> sentence distance : 44
โ line 25
โ Bus" would become `ServiceBus`.
โ Bus"๋ `ServiceBus`๊ฐ ๋ฉ๋๋ค.
=> sentence distance : 18
โ line 27
โ use the following list as the group of services (if the target language supports namespaces):
โ (๋์ ์ธ์ด๊ฐ ๋ค์์คํ์ด์ค๋ฅผ ์ง์ํ๋ ๊ฒฝ์ฐ) ๋ค์ ๋ชฉ๋ก์ ์๋น์ค ๊ทธ๋ฃน์ผ๋ก ์ฌ์ฉํ์ญ์์ค:
=> sentence distance : 83
โ line 31
โ If the client library does not seem to fit into the group list, contact the
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๊ฐ ๊ทธ๋ฃน ๋ชฉ๋ก์ ๋ง์ง ์๋ ๊ฒฝ์ฐ,
=> sentence distance : 68
โ line 31
โ Board] to discuss the namespace requirements.
โ Board]์ ๋ฌธ์ํ์ฌ ๋ค์์คํ์ด์ค ์๊ตฌ ์ฌํญ์ ๋ํด ๋ ผ์ํ์ญ์์ค.
=> sentence distance : 35
โ line 33
โ place the management (Azure Resource Manager) API in the
โ ๊ด๋ฆฌ(Azure ๋ฆฌ์์ค ๊ด๋ฆฌ์) API๋ฅผ
=> sentence distance : 43
โ line 33
โ group. Use the grouping
โ ๊ทธ๋ฃน์ ๋ฐฐ์นํ์ญ์์ค. ๋ค์์คํ์ด์ค์ ๋ํด
=> sentence distance : 23
โ line 33
โ for the namespace. Since more services require control plane APIs than data plane APIs, other namespaces may be used explicitly for control plane only. Data plane usage is by exception only. Additional namespaces that can be used for control plane SDKs include:
โ ๊ทธ๋ฃน์ ์ฌ์ฉํ์ญ์์ค. ๋ ๋ง์ ์๋น์ค๊ฐ ์ปจํธ๋กค ํ๋ ์ธ API๋ฅผ ํ์๋ก ํ๊ธฐ ๋๋ฌธ์, ๋ค๋ฅธ ๋ค์์คํ์ด์ค๋ ์ ์ด ํ๋ ์ธ์๋ง ๋ช ์์ ์ผ๋ก ์ฌ์ฉํ ์ ์์ต๋๋ค. ๋ฐ์ดํฐ ํ๋ ์ธ ์ฌ์ฉ์ ์์ธ์ ๋๋ค. ์ปจํธ๋กค ํ๋ ์ธ SDK์ ์ฌ์ฉํ ์ ์๋ ์ถ๊ฐ ๋ค์์คํ์ด์ค๋ ๋ค์๊ณผ ๊ฐ์ต๋๋ค:
=> sentence distance : 223
โ line 37
โ Many
โ ๋ง์
=> sentence distance : 4
โ line 37
โ APIs do not have a data plane because they deal with management of the
โ API๋
=> sentence distance : 67
โ line 37
โ account. Place the management library in the
โ ๊ณ์ ๊ด๋ฆฌ๋ฅผ ์ฒ๋ฆฌํ๊ธฐ ๋๋ฌธ์ ๋ฐ์ดํฐ ํ๋ ์ธ์ด ์์ต๋๋ค. ๊ด๋ฆฌ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ
=> sentence distance : 40
โ line 37
โ namespace. For example, use `azure.management.costanalysis` instead of `azure.management.management.costanalysis`.
โ ๋ค์์คํ์ด์ค์ ๋ฐฐ์นํ์ญ์์ค. ์๋ฅผ ๋ค์ด, 'azure.management.management.costanalysis' ๋์ 'azure.management.costanalysis'๋ฅผ ์ฌ์ฉํ์ญ์์ค.
=> sentence distance : 67
โ line 39
โ choose similar names for clients that do different things.
โ ์๋ก ๋ค๋ฅธ ์์ ์ ์ํํ๋ ํด๋ผ์ด์ธํธ์ ๋ํด ์ ์ฌํ ์ด๋ฆ์ ์ ํํ์ง ๋ง์ญ์์ค.
=> sentence distance : 51
โ line 41
โ register the chosen namespace with the
โ ์ ํํ ๋ค์์คํ์ด์ค๋ฅผ
=> sentence distance : 37
โ line 41
โ Board]. Open an issue to request the namespace. See [the registered namespace list](registered_namespaces.html) for a list of the currently registered namespaces.
โ Board]์ ๋ฑ๋กํ์ญ์์ค. ๋ค์์คํ์ด์ค๋ฅผ ์์ฒญํ๋ ค๋ฉด ์ด์๋ฅผ ์์ฑํ์ญ์์ค. ํ์ฌ ๋ฑ๋ก๋ ๋ค์์คํ์ด์ค ๋ชฉ๋ก์ [๋ฑ๋ก๋ ๋ค์์คํ์ด์ค ๋ชฉ๋ก](registered_namespaces.html)์ ์ฐธ์กฐํ์ธ์.
=> sentence distance : 117
โ line 43
โ Example Namespaces
โ ๋ค์์คํ์ด์ค ์์
=> sentence distance : 17
โ line 45
โ Here are some examples of namespaces that meet these guidelines:
โ ๋ค์์ ์ด๋ฌํ ์ง์นจ์ ์ถฉ์กฑํ๋ ๋ค์์คํ์ด์ค์ ๋ช ๊ฐ์ง ์์ ๋๋ค:
=> sentence distance : 56
โ line 51
โ (the client library for Notification Hubs)
โ (Notification Hubs๋ฅผ ์ํ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ)
=> sentence distance : 35
โ line 52
โ (the management library for Notification Hubs)
โ (Notification Hubs๋ฅผ ์ํ ๊ด๋ฆฌ ๋ผ์ด๋ธ๋ฌ๋ฆฌ)
=> sentence distance : 38
โ line 54
โ Here are some namespaces that do not meet the guidelines:
โ ๋ค์์ ์ง์นจ์ ๋ง์ง ์๋ ๋ช ๊ฐ์ง ๋ค์์คํ์ด์ค์ ๋๋ค.
=> sentence distance : 51
โ line 56
โ (not in the `Azure` namespace and does not use grouping)
โ (`Azure` ๋ค์์คํ์ด์ค์ ์ํ์ง ์์ผ๋ฉฐ, ๊ทธ๋ฃนํ์ ์ฌ์ฉํ์ง ์์)
=> sentence distance : 42
โ line 57
โ (the grouping is not in the approved list)
โ (๊ทธ๋ฃน์ด ์น์ธ๋ ๋ชฉ๋ก์ ์์)
=> sentence distance : 37
โ line 58
โ (too many levels in the group)
โ (๊ทธ๋ฃน์ ๋๋ฌด ๋ง์ ๋จ๊ณ๊ฐ ์์)
=> sentence distance : 24
โ line 60
โ Client interface
โ ํด๋ผ์ด์ธํธ ์ธํฐํ์ด์ค
=> sentence distance : 15
โ line 62
โ surface will consist of one of more
โ ํ๋ฉด์ ์๋น์๊ฐ ์๋น์ค์ ์ฐ๊ฒฐํ๊ธฐ ์ํด ์ธ์คํด์คํํ๋ ํ๋ ์ด์์
=> sentence distance : 32
โ line 62
โ that the consumer will instantiate to connect to your service, plus a set of supporting types.
โ ๋ฐ ์ง์ ์ ํ์ ์งํฉ์ผ๋ก ๊ตฌ์ฑ๋ฉ๋๋ค.
=> sentence distance : 89
โ line 64
โ suffix.
โ ์ ๋ฏธ์ฌ๋ฅผ ์ฌ์ฉํ์ฌ ์๋น์ค ํด๋ผ์ด์ธํธ ์ ํ์ ์ด๋ฆ์ ์ง์ ํ์ญ์์ค.
=> sentence distance : 34
โ line 64
โ name service client types with the
โ None
=> sentence distance : None
โ line 66
โ There are times when operations require the addition of optional data, provided in what is colloquially known as an "options bag". Libraries should strive for consistent naming.
โ ์ ํ์ ๋ฐ์ดํฐ, ์ฆ ๊ตฌ์ด์ฒด๋ก๋ "์ต์ ๋ฐฑ(options bag)"์ผ๋ก ์๋ ค์ง ๊ฒ ์์ ์ ๊ณต๋๋ ๋ฐ์ดํฐ๋ฅผ ์์ ์์ ์ถ๊ฐํด์ผ ํ๋ ๊ฒฝ์ฐ๊ฐ ์์ต๋๋ค. ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ ์ผ๊ด๋ ์ด๋ฆ์ ์ง์ ํ๊ธฐ ์ํด ๋ ธ๋ ฅํด์ผ ํฉ๋๋ค.
=> sentence distance : 150
โ line 68
โ suffix.
โ ์ ๋ฏธ์ฌ๋ฅผ ์ฌ์ฉํ์ฌ ์๋น์ค ํด๋ผ์ด์ธํธ ์ต์ ๋ฐฑ์ ์ ํ ์ด๋ฆ์ ์ง์ ํด์ผ ํฉ๋๋ค.
=> sentence distance : 41
โ line 68
โ name the type for service client option bags with the
โ None
=> sentence distance : None
โ line 70
โ name operation option bag types with the `options` suffix. For example, if the operation is `get_secret`, then the type of the options bag would be called `get_secret_options`.
โ `option` ์ ๋ฏธ์ฌ๋ฅผ ์ฌ์ฉํ์ฌ ์์ ์ต์ ๋ฐฑ ์ ํ์ ์ด๋ฆ์ ์ง์ ํด์ผ ํฉ๋๋ค. ์๋ฅผ ๋ค์ด, ์์ ์ด `get_secret`์ธ ๊ฒฝ์ฐ ์ต์ ๋ฐฑ์ ์ ํ์ `get_secret_options`์ด๋ผ๊ณ ๋ช ๋ช ๋ฉ๋๋ค.
=> sentence distance : 131
โ line 72
โ place service client types that the consumer is most likely to interact with in the root namespace of the client library (assuming namespaces are supported in the target language). Specialized service clients may be placed in sub-namespaces.
โ ์๋น์๊ฐ ์ํธ ์์ฉํ ๊ฐ๋ฅ์ฑ์ด ๊ฐ์ฅ ๋์ ์๋น์ค ํด๋ผ์ด์ธํธ ์ ํ์ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ๋ฃจํธ ๋ค์์คํ์ด์ค์ ๋ฐฐ์นํ์ญ์์ค(๋ค์์คํ์ด์ค๊ฐ ๋์ ์ธ์ด์์ ์ง์๋๋ค๊ณ ๊ฐ์ ). ํน์ ์๋น์ค ํด๋ผ์ด์ธํธ๋ ํ์ ๋ค์์คํ์ด์ค์ ๋ฐฐ์นํ ์ ์์ต๋๋ค.
=> sentence distance : 215
โ line 74
โ allow the consumer to construct a service client with the minimal information needed to connect and authenticate to the service.
โ ์๋น์๊ฐ ์๋น์ค์ ์ฐ๊ฒฐํ๊ณ ์ธ์ฆํ๋ ๋ฐ ํ์ํ ์ต์ํ์ ์ ๋ณด๋ก ์๋น์ค ํด๋ผ์ด์ธํธ๋ฅผ ๊ตฌ์ฑํ ์ ์๋๋ก ํ์ฉํ์ญ์์ค.
=> sentence distance : 114
โ line 76
โ standardize verb prefixes within a set of client libraries for a service. The service must be able to speak about a specific operation in a cross-language manner within outbound materials (such as documentation, blogs, and public speaking). They cannot do this if the same operation is referred to by different verbs in different languages.
โ ์๋น์ค์ ๋ํ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์ธํธ ๋ด์์ ๋์ฌ ์ ๋์ฌ๋ฅผ ํ์คํํ์ญ์์ค. ์๋น์ค๋ ์์๋ฐ์ด๋ ์๋ฃ(์์: ๋ฌธ์, ๋ธ๋ก๊ทธ ๋ฐ ๋์ค ์ฐ์ค) ๋ด์์ ๊ต์ฐจ ์ธ์ด ๊ฐ ๋ฐฉ์์ผ๋ก ํน์ ์์ ์ ๋ํด ๋งํ ์ ์์ด์ผ ํฉ๋๋ค. ๋์ผํ ์์ ์ด ๋ค๋ฅธ ์ธ์ด์ ๋ค๋ฅธ ๋์ฌ์ ์ํด ์ฐธ์กฐ๋๋ ๊ฒฝ์ฐ์๋ ์ด ์์ ์ ์ํํ ์ ์์ต๋๋ค.
=> sentence distance : 297
โ line 78
โ The following are standard verb prefixes. You should have a good (articulated) reason to have an alternate verb for one of these operations. For example, .NET uses `Gets` instead of
โ ๋ค์์ ํ์ค ๋์ฌ ์ ๋์ฌ์ ๋๋ค. ์ด๋ฌํ ์์ ์ค ํ๋์ ๋ํด ๋์ฒด ๋์ฌ๊ฐ ์์ด์ผ ํ๋ ํ๋นํ(๋ช ํํ) ์ด์ ๊ฐ ์์ด์ผ ํฉ๋๋ค. ์๋ฅผ ๋ค์ด, .NET์ ์ธ์ด์ ๊ด์ฉ์ ์ด๊ธฐ ๋๋ฌธ์
=> sentence distance : 162
โ line 78
โ since it is idiomatic to the language.
โ ๋์ `Gets`๋ฅผ ์ฌ์ฉํฉ๋๋ค.
=> sentence distance : 34
โ line 82
โ support
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๊ฐ ๋ํ๋ด๋ Azure ์๋น์ค์์ ์ ๊ณตํ๋ ๊ธฐ๋ฅ์
=> sentence distance : 37
โ line 82
โ of the features provided by the Azure service the client library represents. Gaps in functionality cause confusion and frustration among developers.
โ ์ง์ํ์ญ์์ค. ๊ธฐ๋ฅ์์ ๊ฒฉ์ฐจ๋ ๊ฐ๋ฐ์๋ค ์ฌ์ด์ ํผ๋๊ณผ ์ข์ ์ ์ผ๊ธฐํฉ๋๋ค.
=> sentence distance : 139
โ line 84
โ Service
โ ์๋น์ค
=> sentence distance : 7
โ line 84
โ versions
โ ๋ฒ์
=> sentence distance : 8
โ line 86
โ The purposes of the client library is to communicate with an
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ๋ชฉ์ ์
=> sentence distance : 58
โ line 86
โ service.
โ ์๋น์ค์ ํต์ ํ๋ ๊ฒ์ ๋๋ค.
=> sentence distance : 14
โ line 86
โ services support multiple
โ ์๋น์ค๋ ์ฌ๋ฌ
=> sentence distance : 24
โ line 86
โ versions. To understand the capabilities of the service, the client library must be able to support multiple service
โ ๋ฒ์ ์ ์ง์ํฉ๋๋ค. ์๋น์ค์ ๊ธฐ๋ฅ์ ์ดํดํ๋ ค๋ฉด, ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๊ฐ ์ฌ๋ฌ ์๋น์ค
=> sentence distance : 108
โ line 86
โ versions.
โ ๋ฒ์ ์ ์ง์ํ ์ ์์ด์ผ ํฉ๋๋ค.
=> sentence distance : 17
โ line 88
โ only target generally available service
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ GA ๋ฒ์ ์ ์ถ์ํ ๋๋ ์ผ๋ฐ์ ์ผ๋ก ์ฌ์ฉ ๊ฐ๋ฅํ ์๋น์ค
=> sentence distance : 39
โ line 88
โ versions when releasing a stable version of the client library.
โ ๋ฒ์ ๋ง ๋์์ผ๋ก ํ์ญ์์ค.
=> sentence distance : 60
โ line 90
โ target the latest generally available service
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ GA ๋ฒ์ ์์๋ ๊ธฐ๋ณธ์ ์ผ๋ก ์ผ๋ฐ์ ์ผ๋ก ์ฌ์ฉ ๊ฐ๋ฅํ ์ต์ ์๋น์ค
=> sentence distance : 46
โ line 90
โ version by default in stable versions of the client library.
โ ๋ฒ์ ์ ๋์์ผ๋ก ํ์ญ์์ค.
=> sentence distance : 57
โ line 92
โ document the service
โ ๊ธฐ๋ณธ์ ์ผ๋ก ์ฌ์ฉ๋๋ ์๋น์ค
=> sentence distance : 19
โ line 92
โ version that is used by default.
โ ๋ฒ์ ์ ๋ฌธ์ํํ์ญ์์ค.
=> sentence distance : 30
โ line 94
โ target the latest public preview
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ๊ณต๊ฐ(public) ๋ฒ ํ ๋ฒ์ ์ ์ถ์ํ ๋๋ ๊ธฐ๋ณธ์ ์ผ๋ก ์ต์ ๊ณต๊ฐ ๋ฏธ๋ฆฌ ๋ณด๊ธฐ
=> sentence distance : 49
โ line 94
โ version by default when releasing a public beta version of the client library.
โ ๋ฒ์ ์ ๋์์ผ๋ก ํ์ญ์์ค.
=> sentence distance : 75
โ line 96
โ include all service
โ `ServiceVersion` ์ด๊ฑฐ(enumerated) ๊ฐ์ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์์ ์ง์ํ๋ ๋ชจ๋ ์๋น์ค
=> sentence distance : 54
โ line 96
โ versions that are supported by the client library in a `ServiceVersion` enumerated value.
โ ๋ฒ์ ์ ํฌํจํ์ญ์์ค.
=> sentence distance : 87
โ line 98
โ enumerated value "match" the version strings in the service
โ ์ด๊ฑฐ ๊ฐ์ ๊ฐ์ด ์๋น์ค
=> sentence distance : 56
โ line 98
โ definition.
โ ์ ์์ ๋ฒ์ ๋ฌธ์์ด๊ณผ "์ผ์น"ํ๋์ง ํ์ธํ์ญ์์ค.
=> sentence distance : 26
โ line 98
โ ensure that the values of the
โ None
=> sentence distance : None
โ line 100
โ {% include requirement/MUST id="general-service-apiversion-7" %} add or replace the `api-version` query parameter on any URI returned by the service e.g., `Operation-Location`, next page links, etc., with the service version passed configured on the client.
โ ์ด ์๊ตฌ ์ฌํญ์ ๋ชฉ์ ์ ์ํด ์๋ฏธ๋ก ์ (semantic) ๋ณ๊ฒฝ์ด ํ์ฉ๋ฉ๋๋ค. ์๋ฅผ ๋ค์ด, ๋ง์ ๋ฒ์ ๋ฌธ์์ด์ ์ ๊ณผ ๋์๋ฅผ ํ์ฉํ๋ SemVer๋ฅผ ๊ธฐ๋ฐ์ผ๋ก ํฉ๋๋ค. ๊ทธ๋ฌ๋ ์ด๋ฌํ ๋ฌธ์๋ ์๋ณ์์์๋ ํ์ฉ๋์ง ์์ต๋๋ค. ๊ฐ๋ฐ์๋ ์๋น์ค์ ๋ฒ์ ์ด `ServiceVersion` ์ด๊ฑฐ ๊ฐ์ ๊ฐ ๊ฐ์ผ๋ก ์ค์ ๋ ๋, ์ด๋ค ์๋น์ค API ๋ฒ์ ์ด ์ฌ์ฉ๋ ์ง **๋ฐ๋์** ๋ช ํํ๊ฒ ์ดํดํ ์ ์์ด์ผ ํฉ๋๋ค.
=> sentence distance : 216
โ line 102
โ For the purposes of this requirement, semantic changes are allowed. For instance, many version strings are based on SemVer, which allows dots and dashes. However, these characters are not allowed in identifiers. The developer **MUST** be able to clearly understand what service API version will be used when the service version is set to each value in the `ServiceVersion` enumerated value.
โ ## ๋ชจ๋ธ ํ์
=> sentence distance : 391
โ line 104
โ ## Model types
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ Azure ์๋น์ค์ ์ฃผ๊ณ ๋ฐ๋ ์ํฐํฐ๋ฅผ ๋ชจ๋ธ ํ์์ผ๋ก ๋ํ๋ ๋๋ค. ํน์ ํ์์ ์๋น์ค ์๋ณต(round-trips)์ ์ฌ์ฉ๋ฉ๋๋ค. ๊ทธ๊ฒ๋ค์ (์ถ๊ฐ ๋๋ ์ ๋ฐ์ดํธ ์์ ์ผ๋ก) ์๋น์ค์ ๋ณด๋ด์ง๊ณ (๊ฐ์ ธ์ค๊ธฐ ์์ ์ผ๋ก) ์๋น์ค์์ ๊ฒ์๋ ์ ์์ต๋๋ค. ๊ทธ๋ค์ ํ์์ ๋ฐ๋ผ ์ด๋ฆ ์ง์ด์ ธ์ผ ํฉ๋๋ค. ์๋ฅผ ๋ค์ด, ์ฑ ๊ตฌ์ฑ(App Configuration)์ `ConfigurationSetting`, ๋๋ ์ด๋ฒคํธ ๊ทธ๋ฆฌ๋(Event Grid)์ `Event`์ ๋๋ค.
=> sentence distance : 255
โ line 106
โ Client libraries represent entities transferred to and from Azure services as model types. Certain types are used for round-trips to the service. They can be sent to the service (as an addition or update operation) and retrieved from the service (as a get operation). These should be named according to the type. For example, a `ConfigurationSetting` in App Configuration, or an `Event` on Event Grid.
โ ๋ชจ๋ธ ํ์ ๋ด์ ๋ฐ์ดํฐ๋ ์ผ๋ฐ์ ์ผ๋ก ๋ ๋ถ๋ถ์ผ๋ก ๋๋ ์ ์์ต๋๋ค - ์๋น์ค์ ๋ํ ์ต์์ ์๋๋ฆฌ์ค ์ค ํ๋๋ฅผ ์ง์ํ๋ ๋ฐ ์ฌ์ฉ๋๋ ๋ฐ์ดํฐ์ ๋ ์ค์ํ ๋ฐ์ดํฐ์ ๋๋ค. `Foo` ํ์์ด ์ฃผ์ด์ง๋ฉด, ๋ ์ค์ํ ์ธ๋ถ ์ ๋ณด๋ฅผ `FooDetails`๋ผ๋ ์ ํ์ผ๋ก ์์งํ๊ณ , `details`์์ฑ์ผ๋ก `Foo`์ ์ฒจ๋ถํ ์ ์์ต๋๋ค.
=> sentence distance : 352
โ line 108
โ Data within the model type can generally be split into two parts - data used to support one of the champion scenarios for the service, and less important data. Given a type `Foo`, the less important details can be gathered in a type called `FooDetails` and attached to `Foo` as the `details` property.
โ ์์:
=> sentence distance : 302
โ line 126
โ Optional parameters and settings to an operation should be collected into an options bag named `Options`. For example, the
โ ์์ ์ ๋ํ ์ ํ์ ๋งค๊ฐ๋ณ์ ๋ฐ ์ค์ ์ `Options`๋ผ๋ ์ต์ ๋ฐฑ์ ์์งํด์ผ ํฉ๋๋ค. ์๋ฅผ ๋ค์ด
=> sentence distance : 109
โ line 126
โ method might take a
โ ๋ฉ์๋๋ ์ ํ์ ๋งค๊ฐ ๋ณ์๋ฅผ ์ง์ ํ๊ธฐ ์ํด
=> sentence distance : 20
โ line 126
โ class for specifying optional parameters.
โ ํด๋์ค๋ฅผ ์ฌ์ฉํ ์ ์์ต๋๋ค.
=> sentence distance : 37
โ line 128
โ Results should use the model type (e.g. `ConfigurationSetting`) where the return value is a complete set of data for the model. However, in cases where a partial schema is returned, use the following types:
โ ๊ฒฐ๊ณผ๋ ๋ฐํ ๊ฐ์ด ๋ชจ๋ธ์ ๋ํ ์์ ํ ๋ฐ์ดํฐ ์ธํธ์ธ ๋ชจ๋ธ ํ์(์: `ConfigurationSetting`)์ ์ฌ์ฉํด์ผ ํฉ๋๋ค. ๊ทธ๋ฌ๋ ๋ถ๋ถ ์คํค๋ง๊ฐ ๋ฐํ๋๋ ๊ฒฝ์ฐ, ๋ค์ ํ์์ ์ฌ์ฉํฉ๋๋ค:
=> sentence distance : 165
โ line 130
โ `Item` for each item in an enumeration if the enumeration returns a partial schema for the model. For example, `GetBlobs()` return an enumeration of `BlobItem`, which contains the blob name and metadata, but not the content of the blob.
โ `Item`: ์ด๊ฑฐ(enumeration)๊ฐ ๋ชจ๋ธ์ ๋ํ ๋ถ๋ถ ์คํค๋ง๋ฅผ ๋ฐํํ๋ ๊ฒฝ์ฐ, ์ด๊ฑฐ์ ๊ฐ ํญ๋ชฉ์ ๋ํ ` Item`๋ฅผ ์ฌ์ฉํฉ๋๋ค. ์๋ฅผ ๋ค์ด, `GetBlobs()`์ Blob์ ์ด๋ฆ๊ณผ ๋ฉํ๋ฐ์ดํฐ๋ฅผ ํฌํจํ์ง๋ง Blob์ ๋ด์ฉ์ ํฌํจํ์ง ์๋ `BlobItem`์ ์ด๊ฑฐ๋ฅผ ๋ฐํํฉ๋๋ค.
=> sentence distance : 178
โ line 131
โ `Result` for the result of an operation. The ` ` is tied to a specific service operation. If the same result can be used for multiple operations, use a suitable noun-verb phrase instead. For example, use `UploadBlobResult` for the result from `UploadBlob`, but `ContainerChangeResult` for results from the various methods that change a blob container.
โ `Result`: ์์ ์ ๊ฒฐ๊ณผ๋ฅผ ์ํด ` Result`๋ฅผ ์ฌ์ฉํฉ๋๋ค. ` `์ ํน์ ์๋น์ค ์์ ์ ์ฐ๊ฒฐ๋ฉ๋๋ค. ์ฌ๋ฌ ์์ ์ ๋์ผํ ๊ฒฐ๊ณผ๋ฅผ ์ฌ์ฉํ ์ ์๋ ๊ฒฝ์ฐ, ์ ์ ํ ๋ช ์ฌ-๋์ฌ๊ตฌ๋ฅผ ๋์ ์ฌ์ฉํ์ญ์์ค. ์๋ฅผ ๋ค์ด, `UploadBlob`์ ๊ฒฐ๊ณผ์๋ `UploadBlobResult`๋ฅผ ์ฌ์ฉํ๋, Blob ์ปจํ ์ด๋๋ฅผ ๋ณ๊ฒฝํ๋ ๋ค์ํ ๋ฉ์๋์ ๊ฒฐ๊ณผ์๋ `ContainerChangeResult`๋ฅผ ์ฌ์ฉํฉ๋๋ค.
=> sentence distance : 263
โ line 133
โ The following table enumerates the various models you might create:
โ ๋ค์ ํ์๋ ์์ฑํ ์ ์๋ ๋ค์ํ ๋ชจ๋ธ์ด ๋์ด๋์ด ์์ต๋๋ค:
=> sentence distance : 58
โ line 135
โ Type
โ ํ์
=> sentence distance : 4
โ line 135
โ Example
โ ์์
=> sentence distance : 7
โ line 135
โ Usage
โ ์ฌ์ฉ
=> sentence distance : 5
โ line 136
โ The full data for a resource
โ ๋ฆฌ์์ค์ ์ ์ฒด ๋ฐ์ดํฐ.
=> sentence distance : 26
โ line 137
โ Less important details about a resource. Attached to `.details` |
โ ๋ฆฌ์์ค์ ๋ํ ๋ ์ค์ํ ์ธ๋ถ์ ๋ณด. `.details`์ ์ฒจ๋ถ๋จ.|
=> sentence distance : 53
โ line 138
โ A partial set of data returned for enumeration
โ ์ด๊ฑฐ์ ๋ํด ๋ฐํ๋ ๋ฐ์ดํฐ์ ๋ถ๋ถ ์งํฉ.
=> sentence distance : 41
โ line 139
โ Optional parameters to a single operation
โ ๋จ์ผ ์์ ์ ๋ํ ์ ํ์ ๋งค๊ฐ๋ณ์.
=> sentence distance : 37
โ line 140
โ A partial or different set of data for a single operation
โ ๋จ์ผ ์์ ์ ๋ํ ๋ถ๋ถ ๋๋ ๋ค๋ฅธ ๋ฐ์ดํฐ ์งํฉ.
=> sentence distance : 50
โ line 141
โ A partial or different set of data for multiple operations on a model
โ ๋ชจ๋ธ์ ๋ํ ์ฌ๋ฌ ์์ ์ ๋ํ ๋ถ๋ถ์ ๋๋ ๋ค๋ฅธ ๋ฐ์ดํฐ ์งํฉ.
=> sentence distance : 60
โ line 143
โ Network requests
โ ๋คํธ์ํฌ ์์ฒญ
=> sentence distance : 15
โ line 145
โ Since the client library generally wraps one or more
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ ์ผ๋ฐ์ ์ผ๋ก ํ๋ ์ด์์
=> sentence distance : 48
โ line 145
โ requests, it is important to support standard network capabilities. Asynchronous programming techniques are not widely understood, although such techniques are essential in developing scalable web services and required in certain environments (such as mobile or Node environments). Many developers prefer synchronous method calls for their easy semantics when learning how to use a technology. In addition, consumers have come to expect certain capabilities in a network stack - capabilities such as call cancellation, automatic retry, and logging.
โ ์์ฒญ์ ๋ํํ๋ฏ๋ก, ํ์ค ๋คํธ์ํฌ ๊ธฐ๋ฅ์ ์ง์ํ๋ ๊ฒ์ด ์ค์ํฉ๋๋ค. ๋น๋๊ธฐ ํ๋ก๊ทธ๋๋ฐ ๊ธฐ๋ฒ์ ๋๋ฆฌ ์ดํด๋์ง๋ ์์ง๋ง, ์ด๋ฌํ ๊ธฐ๋ฒ์ ํ์ฅ ๊ฐ๋ฅํ ์น ์๋น์ค ๊ฐ๋ฐ์ ํ์์ ์ด๋ฉฐ ํน์ ํ๊ฒฝ(๋ชจ๋ฐ์ผ ๋๋ ๋ ธ๋ ํ๊ฒฝ)์์ ํ์ํฉ๋๋ค. ๋ง์ ๊ฐ๋ฐ์๋ค์ ๊ธฐ์ ์ฌ์ฉ๋ฒ์ ๋ฐฐ์ธ ๋ ์ฌ์ด ์๋ฏธ๋ก (semantics) ๋๋ฌธ์ ๋๊ธฐ์ ๋ฉ์๋ ํธ์ถ์ ์ ํธํฉ๋๋ค. ๋ํ ์๋น์๋ ๋คํธ์ํฌ ์คํ์์ ํธ์ถ ์ทจ์, ์๋ ์ฌ์๋, ๋ก๊น ๊ณผ ๊ฐ์ ํน์ ๊ธฐ๋ฅ์ ๊ธฐ๋ํ๊ฒ ๋์์ต๋๋ค.
=> sentence distance : 484
โ line 147
โ support both synchronous and asynchronous method calls, except where the language or default runtime does not support one or the other.
โ ๋๊ธฐ ๋ฐ ๋น๋๊ธฐ ๋ฉ์๋ ํธ์ถ์ ๋ชจ๋ ์ง์ํ์ญ์์ค. ์ธ์ด ๋๋ ๊ธฐ๋ณธ ๋ฐํ์์ด ๋ ์ค ํ๋๋ฅผ ์ง์ํ์ง ์๋ ๊ฒฝ์ฐ๋ ์์ธ์ ๋๋ค.
=> sentence distance : 117
โ line 149
โ ensure that the consumer can identify which methods are async and which are synchronous.
โ ์๋น์๊ฐ ์ด๋ค ๋ฉ์๋๊ฐ ๋น๋๊ธฐ์์ด๊ณ , ์ด๋ค ๋ฉ์๋๊ฐ ๋๊ธฐ์์ธ์ง ์๋ณํ ์ ์๋์ง ํ์ธํ์ญ์์ค.
=> sentence distance : 77
โ line 151
โ When an application makes a network request, the network infrastructure (like routers) and the called service may take a long time to respond and, in fact, may never respond. A well-written application SHOULD NEVER give up its control to the network infrastucture or service. Here are some examples as to why this is so important:
โ ์ ํ๋ฆฌ์ผ์ด์ ์ด ๋คํธ์ํฌ ์์ฒญ์ ํ ๋, (๋ผ์ฐํฐ์ ๊ฐ์) ๋คํธ์ํฌ ์ธํ๋ผ์ ํธ์ถ๋ ์๋น์ค๊ฐ ์๋ตํ๋ ๋ฐ ์ค๋ ์๊ฐ์ด ๊ฑธ๋ฆด ์ ์์ผ๋ฉฐ, ์ค์ ๋ก๋ ์์ ์๋ตํ์ง ์์ ์ ์์ต๋๋ค. ์ ์์ฑ๋ ์ ํ๋ฆฌ์ผ์ด์ ์ ๋คํธ์ํฌ ์ธํ๋ผ๋ ์๋น์ค์ ๋ํ ์ ์ด๋ฅผ ์ ๋ ํฌ๊ธฐํด์๋ ์ ๋ฉ๋๋ค. ์ด๊ฒ์ด ์ ์ค์ํ์ง์ ๋ํ ๋ช ๊ฐ์ง ์๋ ๋ค์๊ณผ ๊ฐ์ต๋๋ค:
=> sentence distance : 282
โ line 153
โ When an orchestrator needs to terminate a service (due to scale in, reconfiguration, or upgrading to a new version), the orchestrator typically notifies a running service instance by sending the
โ ์ค์ผ์คํธ๋ ์ดํฐ๊ฐ (์ค์ผ์ผ ์ธ, ์ฌ๊ตฌ์ฑ ๋๋ ์ ๋ฒ์ ์ผ๋ก ์ ๊ทธ๋ ์ด๋ํ๊ธฐ ์ํด) ์๋น์ค๋ฅผ ์ข ๋ฃํด์ผ ํ๋ ๊ฒฝ์ฐ, ์ผ๋ฐ์ ์ผ๋ก ์ค์ผ์คํธ๋ ์ดํฐ๋
=> sentence distance : 178
โ line 153
โ SIGINT. When the service receives this signal, it should terminate as quickly and gracefully as possible by setting a cancellation mechanism which is honored by all network operations that are currently in progress.
โ SIGINT๋ฅผ ์ ์กํ์ฌ ์คํ ์ค์ธ ์๋น์ค ์ธ์คํด์ค์ ์๋ฆฝ๋๋ค. ์๋น์ค๊ฐ ์ด ์ ํธ๋ฅผ ์์ ํ๋ฉด, ํ์ฌ ์งํ ์ค์ธ ๋ชจ๋ ๋คํธ์ํฌ ์์ ์ ์ ์ฉ๋๋ ์ทจ์ ๋ฉ์ปค๋์ฆ์ ์ค์ ํ์ฌ ์ต๋ํ ๋น ๋ฅด๊ณ ์ ์์ ์ผ๋ก(gracefully) ์ข ๋ฃํด์ผ ํฉ๋๋ค.
=> sentence distance : 180
โ line 154
โ When a consumer's web server receives a request, it may set a time limit indicating how much time it is allowing before it must give a response to the user.
โ ์๋น์์ ์น ์๋ฒ๊ฐ ์์ฒญ์ ์์ ํ๋ฉด, ์ฌ์ฉ์์๊ฒ ์๋ต์ ์ ๊ณตํด์ผ ํ๊ธฐ ์ ์ ํ์ฉ๋๋ ์๊ฐ์ ๋ํ๋ด๋ ์๊ฐ ์ ํ์ ์ค์ ํ ์ ์์ต๋๋ค.
=> sentence distance : 137
โ line 155
โ When a consumer's
โ ์๋น์์
=> sentence distance : 17
โ line 155
โ application makes a request to an
โ ์ ํ๋ฆฌ์ผ์ด์ ์ด ๋น์ฌ์ SDK๋ฅผ ํตํด
=> sentence distance : 30
โ line 155
โ service via our SDK, the GUI might offer a cancel button so that the end user can indicate that they are no longer in waiting for an operation or operations to complete.
โ ์๋น์ค์ ์์ฒญํ ๋, GUI์์ ์ทจ์ ๋ฒํผ์ ์ ๊ณตํ์ฌ ์ต์ข ์ฌ์ฉ์๊ฐ ๋ ์ด์ ์์ ์ด ์๋ฃ๋๊ธฐ๋ฅผ ๊ธฐ๋ค๋ฆฌ๊ณ ์์ง ์์์ ๋ํ๋ผ ์ ์์ต๋๋ค.
=> sentence distance : 146
โ line 157
โ The best way for consumers to work with cancellation is to think of cancellation objects as forming a tree. For example:
โ ์๋น์๊ฐ ์ทจ์ ์์ ์ ์ํํ๋ ๊ฐ์ฅ ์ข์ ๋ฐฉ๋ฒ์ ์ทจ์ ๊ฐ์ฒด๋ฅผ ํธ๋ฆฌ๋ฅผ ํ์ฑํ๋ ๊ฒ์ผ๋ก ์๊ฐํ๋ ๊ฒ์ ๋๋ค. ์๋ฅผ ๋ค์ด:
=> sentence distance : 103
โ line 159
โ Cancelling a parent automatically cancels its children.
โ ๋ถ๋ชจ ํญ๋ชฉ์ ์ทจ์ํ๋ฉด ์์ ํญ๋ชฉ์ด ์๋์ผ๋ก ์ทจ์๋ฉ๋๋ค.
=> sentence distance : 50
โ line 160
โ Children can time out sooner than their parent but cannot extend the total time.
โ ์์ ํญ๋ชฉ์ ๋ถ๋ชจ๋ณด๋ค ์ผ์ฐ ํ์์์ํ ์ ์์ง๋ง ์ด ์๊ฐ์ ์ฐ์ฅํ ์๋ ์์ต๋๋ค.
=> sentence distance : 68
โ line 161
โ Cancellation can happen due to timeout or due to a manual/explicit cancel.
โ ์ทจ์๋ ์๊ฐ ์ด๊ณผ ๋๋ ์๋/๋ช ์์ ์ทจ์๋ก ์ธํด ๋ฐ์ํ ์ ์์ต๋๋ค.
=> sentence distance : 65
โ line 163
โ Here is an example of how an application would use the tree of cancellations:
โ ๋ค์์ ์ ํ๋ฆฌ์ผ์ด์ ์ด ์ทจ์ ํธ๋ฆฌ๋ฅผ ์ฌ์ฉํ๋ ๋ฐฉ๋ฒ์ ์์ ๋๋ค:
=> sentence distance : 70
โ line 165
โ When an application starts, it should create a cancellation object that represents the entire application; this object is explicitly terminated in response to the application receiving a
โ ์ ํ๋ฆฌ์ผ์ด์ ์ด ์์๋๋ฉด, ์ ์ฒด ์ ํ๋ฆฌ์ผ์ด์ ์ ๋ํ๋ด๋ ์ทจ์ ๊ฐ์ฒด๋ฅผ ๋ง๋ค์ด์ผ ํฉ๋๋ค. ์ด ๊ฐ์ฒด๋
=> sentence distance : 175
โ line 165
โ notification.
โ ์๋ฆผ์ ๋ฐ๋ ์ ํ๋ฆฌ์ผ์ด์ ์ ๋ํ ์๋ต์ผ๋ก ๋ช ์์ ์ผ๋ก ์ข ๋ฃ๋ฉ๋๋ค.
=> sentence distance : 34
โ line 166
โ When a web server receives an incoming request, it would create a new cancellation object that is a child of the application node. The new cancellation object would specify a maximum time that the web server is allowed to operate on the request.
โ ์น ์๋ฒ๊ฐ ์์ ์์ฒญ์ ๋ฐ์ผ๋ฉด, ์ ํ๋ฆฌ์ผ์ด์ ๋ ธ๋์ ํ์ ํญ๋ชฉ์ธ ์ ์ทจ์ ๊ฐ์ฒด๋ฅผ ๋ง๋ญ๋๋ค. ์ ์ทจ์ ๊ฐ์ฒด๋ ์น ์๋ฒ๊ฐ ์์ฒญ์ ๋ํด ์์ ํ ์ ์๋ ์ต๋ ์๊ฐ์ ์ง์ ํฉ๋๋ค.
=> sentence distance : 217
โ line 167
โ As part of operating on the incoming request, the web server might need to make multiple requests to other services (like a database). If these requests can be made serially or in parallel, then they might share the previously created cancellation object. However, if the web server wants to limit the time spent on 1 or more of the requests, it can create a new cancellation object (with the desired timeout value) and make this object a child of the incoming node; this way, the individual request times out either when the overall request times out or when the maximum time for this operation is exceeded
โ ์์ ์์ฒญ์ ๋ํ ์์ ์ ์ผ๋ถ๋ก ์น ์๋ฒ๋ (๋ฐ์ดํฐ๋ฒ ์ด์ค์ ๊ฐ์) ๋ค๋ฅธ ์๋น์ค์ ์ฌ๋ฌ ์์ฒญ์ ํด์ผ ํ ์ ์์ต๋๋ค. ์ด๋ฌํ ์์ฒญ์ ์ง๋ ฌ ๋๋ ๋ณ๋ ฌ๋ก ์ํํ ์ ์๋ ๊ฒฝ์ฐ, ์ด์ ์ ์์ฑ๋ ์ทจ์ ๊ฐ์ฒด๋ฅผ ๊ณต์ ํ ์ ์์ต๋๋ค. ๊ทธ๋ฌ๋ ์น ์๋ฒ๊ฐ ํ๋ ์ด์์ ์์ฒญ์ ์์๋๋ ์๊ฐ์ ์ ํํ๋ ค๋ ๊ฒฝ์ฐ, (์ํ๋ ์๊ฐ ์ด๊ณผ ๊ฐ์ผ๋ก) ์ ์ทจ์ ๊ฐ์ฒด๋ฅผ ๋ง๋ค๊ณ , ์ด ๊ฐ์ฒด๋ฅผ ๋ค์ด์ค๋ ๋ ธ๋์ ์์ ๊ฐ์ฒด๋ก ๋ง๋ค ์ ์์ต๋๋ค. ์ด๋ ๊ฒ ํ๋ฉด ์ ์ฒด ์์ฒญ ์๊ฐ์ด ์ด๊ณผ๋๊ฑฐ๋ ์ด ์์ ์ ์ต๋ ์๊ฐ์ด ์ด๊ณผ๋ ๋(๋ ์ค ๋จผ์ ๋ฐ์ํ๋ ๊ฒฝ์ฐ) ๊ฐ๋ณ ์์ฒญ ์๊ฐ์ด ์ด๊ณผ๋ฉ๋๋ค.
=> sentence distance : 524
โ line 167
โ whichever happens first.
โ ์ฌ๋ฌ ์์ฒญ์ด ๋ณ๋ ฌ๋ก ์ด๋ฃจ์ด์ง ๊ฒฝ์ฐ, ์ผ๋ฐ์ ์ผ๋ก ์๋น์๋ ๊ทธ ์ค ํ๋๊ฐ ์คํจํ๋ฉด ๋ชจ๋ ์์ฒญ์ ์ทจ์ํ๊ณ ์ ํฉ๋๋ค. ์ด๊ฒ์ ์ง์๋๋ ์๋๋ฆฌ์ค์ฌ์ผ ํฉ๋๋ค.
=> sentence distance : 79
โ line 170
โ accept platform-native cancellation tokens (that implement a timeout) on all asynchronous calls.
โ ๋ชจ๋ ๋น๋๊ธฐ์ ํธ์ถ์์ (์๊ฐ ์ด๊ณผ๋ฅผ ๊ตฌํํ๋) ํ๋ซํผ ๊ณ ์ (platform-native) ์ทจ์ ํ ํฐ์ ์๋ฝํ์ญ์์ค.
=> sentence distance : 79
โ line 172
โ check cancellation tokens only on
โ ์ทจ์ ํ ํฐ์
=> sentence distance : 32
โ line 172
โ calls (such as network requests and file loads). Do not check cancellation tokens in between
โ ํตํ(์์: ๋คํธ์ํฌ ์์ฒญ ๋ฐ ํ์ผ ๋ก๋)์์๋ง ํ์ธํด์ผ ํฉ๋๋ค. ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ๋ด์์
=> sentence distance : 82
โ line 172
โ calls within the client library (for example, when processing data between
โ ํธ์ถ ์ฌ์ด์ ์ทจ์ ํ ํฐ์ ํ์ธํ์ง ๋ง์ญ์์ค(์:
=> sentence distance : 69
โ line 172
โ calls).
โ ํธ์ถ ๊ฐ์ ๋ฐ์ดํฐ๋ฅผ ์ฒ๋ฆฌํ ๋). ์ทจ์ ํ ํฐ์ I/O ํตํ(์: ๋คํธ์ํฌ ์์ฒญ ๋ฐ ํ์ผ ๋ก๋)์์๋ง ํ์ธํด์ผ ํฉ๋๋ค. ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ๋ด์์ I/O ํธ์ถ ์ฌ์ด์ ์ทจ์ ํ ํฐ์ ํ์ธํ์ง ๋ง์ญ์์ค(์์: I/O ํธ์ถ ๊ฐ์ ๋ฐ์ดํฐ๋ฅผ ์ฒ๋ฆฌํ ๋).
=> sentence distance : 134
โ line 174
โ leak the underlying protocol transport implementation details to the consumer. All types from the protocol transport implementation must be appropriately abstracted.
โ ๊ธฐ๋ณธ ํ๋กํ ์ฝ ์ ์ก ๊ตฌํ ์ธ๋ถ ์ ๋ณด๋ฅผ ์๋น์์๊ฒ ๋์คํ์ง ๋ง์ญ์์ค. ํ๋กํ ์ฝ ์ ์ก ๊ตฌํ์ ๋ชจ๋ ์ ํ์ ์ ์ ํ๊ฒ ์ถ์ํ๋์ด์ผ ํฉ๋๋ค.
=> sentence distance : 149
โ line 176
โ Authentication
โ ์ธ์ฆ
=> sentence distance : 14
โ line 177
โ services use a variety of different authentication schemes to allow clients to access the service. Conceptually, there are two entities responsible in this process: a credential and an authentication policy. Credentials provide confidential authentication data. Authentication policies use the data provided by a credential to authenticate requests to the service.
โ ์๋น์ค๋ ํด๋ผ์ด์ธํธ๊ฐ ์๋น์ค์ ์ก์ธ์คํ ์ ์๋๋ก ๋ค์ํ ์ธ์ฆ ์ฒด๊ณ๋ฅผ ์ฌ์ฉํฉ๋๋ค. ๊ฐ๋ ์ ์ผ๋ก ์ด ํ๋ก์ธ์ค์๋ ์๊ฒฉ ์ฆ๋ช ๊ณผ ์ธ์ฆ ์ ์ฑ ์ด๋ผ๋ ๋ ๊ฐ์ง ์ํฐํฐ๊ฐ ์์ต๋๋ค. ์๊ฒฉ ์ฆ๋ช ์ ๊ธฐ๋ฐ ์ธ์ฆ ๋ฐ์ดํฐ๋ฅผ ์ ๊ณตํฉ๋๋ค. ์ธ์ฆ ์ ์ฑ ์ ์๊ฒฉ ์ฆ๋ช ์์ ์ ๊ณตํ ๋ฐ์ดํฐ๋ฅผ ์ฌ์ฉํ์ฌ ์๋น์ค์ ๋ํ ์์ฒญ์ ์ธ์ฆํฉ๋๋ค.
=> sentence distance : 327
โ line 179
โ Primarily, all
โ ๊ธฐ๋ณธ์ ์ผ๋ก ๋ชจ๋
=> sentence distance : 13
โ line 179
โ services should support
โ ์๋น์ค๋
=> sentence distance : 23
โ line 179
โ token authentication, and all clients must support authenticating requests in this manner.
โ ํ ํฐ ์ธ์ฆ์ ์ง์ํด์ผ ํ๋ฉฐ ๋ชจ๋ ํด๋ผ์ด์ธํธ๋ ์ด๋ฌํ ๋ฐฉ์์ผ๋ก ์ธ์ฆ ์์ฒญ์ ์ง์ํด์ผ ํฉ๋๋ค.
=> sentence distance : 79
โ line 181
โ provide a service client constructor or factory that accepts an instance of the
โ Azure Core์์
=> sentence distance : 73
โ line 181
โ abstraction from Azure Core.
โ ์ถ์ํ ์ธ์คํด์ค๋ฅผ ํ์ฉํ๋ ์๋น์ค ํด๋ผ์ด์ธํธ ์์ฑ์ ๋๋ ํฉํ ๋ฆฌ๋ฅผ ์ ๊ณตํ์ญ์์ค.
=> sentence distance : 40
โ line 183
โ persist, cache, or reuse tokens returned from the token credential. This is __CRITICAL__ as credentials generally have a short validity period and the token credential is responsible for refreshing these.
โ ํ ํฐ ์๊ฒฉ ์ฆ๋ช ์์ ๋ฐํ๋ ํ ํฐ์ ์ ์ง, ์บ์ ๋๋ ์ฌ์ฌ์ฉํ์ง ๋ง์ญ์์ค. ์ผ๋ฐ์ ์ผ๋ก ์๊ฒฉ ์ฆ๋ช ์ ์ ํจ ๊ธฐ๊ฐ์ด ์งง๊ณ , ํ ํฐ ์๊ฒฉ ์ฆ๋ช ์ด ์ด๋ฌํ ์๊ฒฉ ์ฆ๋ช ์ ๊ฐฑ์ ํ๋ ์ญํ ์ ๋ด๋นํ๊ธฐ ๋๋ฌธ์ ์ด๋ __๋งค์ฐ ์ค์ํฉ๋๋ค__.
=> sentence distance : 178
โ line 185
โ use authentication policy implementations from the
โ ์ฌ์ฉ ๊ฐ๋ฅํ ๊ฒฝ์ฐ
=> sentence distance : 48
โ line 185
โ library where available.
โ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ์ธ์ฆ ์ ์ฑ ๊ตฌํ์ ์ฌ์ฉํ์ญ์์ค.
=> sentence distance : 22
โ line 187
โ reserve the API surface needed for TokenCredential authentication, in the rare case that a service does not yet support
โ ์๋น์ค๊ฐ ์์ง
=> sentence distance : 118
โ line 187
โ authentication.
โ ์ธ์ฆ์ ์ง์ํ์ง ์๋ ๊ฒฝ์ฐ๊ฐ ๋๋ฌผ์ง๋ง, ์ด๋ฌํ ๊ฒฝ์ฐ TokenCredential ์ธ์ฆ์ ํ์ํ API ํ๋ฉด์ ์ ์งํ์ญ์์ค.
=> sentence distance : 63
โ line 189
โ OAuth, services may provide custom authentication schemes. In this case the following guidelines apply.
โ OAuth ์ธ์๋ ์๋น์ค๋ ์ฌ์ฉ์ ์ง์ ์ธ์ฆ ์ฒด๊ณ๋ฅผ ์ ๊ณตํ ์ ์์ต๋๋ค. ์ด ๊ฒฝ์ฐ ๋ค์ ์ง์นจ์ด ์ ์ฉ๋ฉ๋๋ค.
=> sentence distance : 85
โ line 191
โ support all authentication schemes that the service supports.
โ ์๋น์ค๊ฐ ์ง์ํ๋ ๋ชจ๋ ์ธ์ฆ ์ฒด๊ณ๋ฅผ ์ง์ํ์ญ์์ค.
=> sentence distance : 55
โ line 193
โ define a public custom credential type which enables clients to authenticate requests using the custom scheme.
โ ํด๋ผ์ด์ธํธ๊ฐ ์ฌ์ฉ์ ์ง์ ์ฒด๊ณ๋ฅผ ์ฌ์ฉํ์ฌ ์์ฒญ์ ์ธ์ฆํ ์ ์๋๋ก ํ๋ ๊ณต๊ฐ ์ฌ์ฉ์ ์ง์ ์๊ฒฉ ์ฆ๋ช ์ ํ์ ์ ์ํ์ญ์์ค.
=> sentence distance : 95
โ line 195
โ define custom credential types extending or implementing the
โ Azure Core์์
=> sentence distance : 53
โ line 195
โ abstraction from Azure Core. This is especially true in type safe languages where extending or implementing this abstraction would break the type safety of other service clients, allowing users to instantiate them with the custom credential of the wrong service.
โ ์ถ์ํ๋ฅผ ํ์ฅํ๊ฑฐ๋ ๊ตฌํํ๋ ์ฌ์ฉ์ ์ง์ ์๊ฒฉ ์ฆ๋ช ํ์์ ์ ์ํ๋ฉด ์ ๋ฉ๋๋ค. ์ด๋ ํนํ ์ด๋ฌํ ์ถ์ํ๋ฅผ ํ์ฅํ๊ฑฐ๋ ๊ตฌํํ๋ฉด ๋ค๋ฅธ ์๋น์ค ํด๋ผ์ด์ธํธ์ ํ์ ์์ ์ฑ์ด ํผ์๋์ด ์ฌ์ฉ์๊ฐ ์๋ชป๋ ์๋น์ค์ ๋ํ ์ฌ์ฉ์ ์ ์ ์๊ฒฉ ์ฆ๋ช ์ผ๋ก ํด๋น ํด๋ผ์ด์ธํธ๋ฅผ ์ธ์คํด์คํํ ์ ์๋ ํ์ ์ธ์ดํ(type safe) ์ธ์ด์์ ๋์ฑ ๊ทธ๋ ์ต๋๋ค.
=> sentence distance : 222
โ line 197
โ define custom credential types in the same namespace and package as the client, or in a service group namespace and shared package, not in
โ ์ฌ์ฉ์ ์ง์ ์๊ฒฉ ์ฆ๋ช ํ์์
=> sentence distance : 134
โ line 197
โ Core or
โ Core๋
=> sentence distance : 3
โ line 197
โ Identity.
โ Identity๊ฐ ์๋, ํด๋ผ์ด์ธํธ์ ๋์ผํ ๋ค์ ์คํ์ด์ค ๋ฐ ํจํค์ง ๋๋ ์๋น์ค ๊ทธ๋ฃน ๋ค์์คํ์ด์ค์ ๊ณต์ ํจํค์ง ์์ ์ง์ ํ์ญ์์ค.
=> sentence distance : 65
โ line 199
โ prepend custom credential type names with the service name or service group name to provide clear context to its intended scope and usage.
โ ์๋น์ค ์ด๋ฆ ๋๋ ์๋น์ค ๊ทธ๋ฃน ์ด๋ฆ์ ์ฌ์ฉ์ ์ง์ ์๊ฒฉ ์ฆ๋ช ์ ํ ์ด๋ฆ์ ์ถ๊ฐํ์ฌ ์๋ํ ๋ฒ์ ๋ฐ ์ฌ์ฉ์ ๋ํ ๋ช ํํ ์ปจํ ์คํธ๋ฅผ ์ ๊ณตํ์ญ์์ค.
=> sentence distance : 118
โ line 201
โ append Credential to the end of the custom credential type name. Note this must be singular not plural.
โ ์ฌ์ฉ์ ์ง์ ์๊ฒฉ ์ฆ๋ช ์ ํ ์ด๋ฆ ๋์ ์๊ฒฉ ์ฆ๋ช (Credential)์ ์ถ๊ฐํ์ญ์์ค. ์ด๊ฒ์ ๋ณต์๊ฐ ์๋ ๋จ์์ฌ์ผ ํฉ๋๋ค.
=> sentence distance : 80
โ line 203
โ define a constructor or factory for the custom credential type which takes in ALL data needed for the custom authentication protocol.
โ ์ฌ์ฉ์ ์ ์ ์ธ์ฆ ํ๋กํ ์ฝ์ ํ์ํ ๋ชจ๋ ๋ฐ์ดํฐ๋ฅผ ๊ฐ์ ธ์ค๋ ์ฌ์ฉ์ ์ ์ ์๊ฒฉ ์ฆ๋ช ์ ํ์ ๋ํ ์์ฑ์ ๋๋ ํฉํ ๋ฆฌ๋ฅผ ์ ์ํ์ญ์์ค.
=> sentence distance : 115
โ line 205
โ define an update method which accepts all mutable credential data, and updates the credential in an atomic, thread safe manner.
โ ๋ณ๊ฒฝ ๊ฐ๋ฅํ ๋ชจ๋ ์๊ฒฉ ์ฆ๋ช ๋ฐ์ดํฐ๋ฅผ ํ์ฉํ๊ณ , ์์์ ์ธ ์ค๋ ๋ ์์ ๋ฐฉ์์ผ๋ก ์๊ฒฉ ์ฆ๋ช ์ ๊ฐฑ์ ํ๋ ์ ๋ฐ์ดํธ ๋ฉ์๋๋ฅผ ์ ์ํ์ญ์์ค.
=> sentence distance : 111
โ line 207
โ define public settable properties or fields which allow users to update the authentication data directly in a non-atomic manner.
โ ์ฌ์ฉ์๊ฐ ์ธ์ฆ ๋ฐ์ดํฐ๋ฅผ ๋น์์์ ๋ฐฉ์์ผ๋ก ์ง์ ์ ๋ฐ์ดํธํ ์ ์๋๋ก ๊ณต๊ฐ ์ค์ ๊ฐ๋ฅํ ์์ฑ ๋๋ ํ๋๋ฅผ ์ ์ํ์ง ๋ง์ญ์์ค.
=> sentence distance : 112
โ line 209
โ define public properties or fields which allow users to access the authentication data directly. They are most often not needed by end users, and are difficult to use in a thread safe manner. In the case that exposing the authentication data is necessary, all the data needed to authenticate requests should be returned from a single API which guarantees the data returned is in a consistent state.
โ ์ฌ์ฉ์๊ฐ ์ธ์ฆ ๋ฐ์ดํฐ์ ์ง์ ์ ๊ทผํ ์ ์๋๋ก ํ์ฉํ๋ ๊ณต์ฉ ์์ฑ ๋๋ ํ๋๋ฅผ ์ ์ํ๋ฉด ์ ๋ฉ๋๋ค. ์ด๋ ์ต์ข ์ฌ์ฉ์๊ฐ ํ์๋ก ํ์ง ์๋ ๊ฒฝ์ฐ๊ฐ ๋๋ถ๋ถ์ด๋ฉฐ, ์ค๋ ๋๋ก๋ถํฐ ์์ ํ ๋ฐฉ์์ผ๋ก ์ฌ์ฉํ๊ธฐ ์ด๋ ต์ต๋๋ค. ์ธ์ฆ ๋ฐ์ดํฐ๋ฅผ ๋ ธ์ถํด์ผ ํ๋ ๊ฒฝ์ฐ, ์์ฒญ์ ์ธ์ฆํ๋ ๋ฐ ํ์ํ ๋ชจ๋ ๋ฐ์ดํฐ๋ ๋ฐํ๋ ๋ฐ์ดํฐ๊ฐ ์ผ๊ด๋ ์ํ์์ ๋ณด์ฅํ๋ ๋จ์ผ API์์ ๋ฐํ๋์ด์ผ ํฉ๋๋ค.
=> sentence distance : 345
โ line 211
โ provide service client constructors or factories that accept all supported credential types.
โ ์ง์๋๋ ๋ชจ๋ ์๊ฒฉ ์ฆ๋ช ์ ํ์ ํ์ฉํ๋ ์๋น์ค ํด๋ผ์ด์ธํธ ์์ฑ์ ๋๋ ํฉํ ๋ฆฌ๋ฅผ ์ ๊ณตํ์ญ์์ค.
=> sentence distance : 82
โ line 213
โ Client libraries may support providing credential data via a connection string __ONLY IF__ the service provides a connection string to users via the portal or other tooling. Connection strings are generally good for getting started as they are easily integrated into an application by copy/paste from the portal. However, connection strings are considered a lesser form of authentication because the credentials cannot be rotated within a running process.
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ ์๋น์ค๊ฐ ํฌํธ ๋๋ ๊ธฐํ ๋๊ตฌ๋ฅผ ํตํด ์ฌ์ฉ์์๊ฒ ์ฐ๊ฒฐ ๋ฌธ์์ด(connection string)์ ์ ๊ณตํ๋ __๊ฒฝ์ฐ์๋ง__ ์ฐ๊ฒฐ ๋ฌธ์์ด์ ํตํ ์๊ฒฉ ์ฆ๋ช ๋ฐ์ดํฐ ์ ๊ณต์ ์ง์ํ ์ ์์ต๋๋ค. ์ฐ๊ฒฐ ๋ฌธ์์ด์ ์ผ๋ฐ์ ์ผ๋ก ํฌํธ์์ ๋ณต์ฌ/๋ถ์ฌ๋ฃ๊ธฐ๋ฅผ ํตํด ์ ํ๋ฆฌ์ผ์ด์ ์ ์ฝ๊ฒ ํตํฉ๋๋ฏ๋ก ์์ํ๊ธฐ์ ์ข์ต๋๋ค. ๊ทธ๋ฌ๋ ์ฐ๊ฒฐ ๋ฌธ์์ด์ ์คํ ์ค์ธ ํ๋ก์ธ์ค ๋ด์์ ์๊ฒฉ ์ฆ๋ช ์ ๊ต์ฒดํ ์ ์๊ธฐ ๋๋ฌธ์, ๋ ์ธ์ฆ๋ ํ์์ผ๋ก ๊ฐ์ฃผ๋ฉ๋๋ค.
=> sentence distance : 390
โ line 215
โ support constructing a service client with a connection string unless such connection string is available within tooling (for copy/paste operations).
โ ๋๊ตฌ ๋ด์์ (๋ณต์ฌ/๋ถ์ฌ๋ฃ๊ธฐ ์์ ์ฉ์ผ๋ก) ์ด๋ฌํ ์ฐ๊ฒฐ ๋ฌธ์์ด์ ์ฌ์ฉํ ์ ์๋ ๊ฒฝ์ฐ๊ฐ ์๋๋ผ๋ฉด, ์ฐ๊ฒฐ ๋ฌธ์์ด๋ก ์๋น์ค ํด๋ผ์ด์ธํธ๋ฅผ ๊ตฌ์ฑํ๋ ๊ฒ์ ์ง์ํ์ง ๋ง์ญ์์ค.
=> sentence distance : 131
โ line 217
โ Response formats
โ ์๋ต ํ์
=> sentence distance : 15
โ line 219
โ Requests to the service fall into two basic groups - methods that make a single logical request, or a deterministic sequence of requests. An example of a *single logical request* is a request that may be retried inside the operation. An example of a *deterministic sequence of requests* is a paged operation.
โ ์๋น์ค์ ๋ํ ์์ฒญ์ ๋ ๊ฐ์ง ๊ธฐ๋ณธ ๊ทธ๋ฃน, ์ฆ ๋จ์ผ ๋ ผ๋ฆฌ์ (single logical) ์์ฒญ์ ๋ง๋๋ ๋ฉ์๋ ๋๋ ์์ฒญ์ ๊ฒฐ์ ๋ก ์ ์ํ์ค(deterministic sequence)๋ก ๋๋ฉ๋๋ค. *๋จ์ผ ๋ ผ๋ฆฌ์ ์์ฒญ*์ ์๋ ์์ ๋ด์์ ์ฌ์๋ํ ์ ์๋ ์์ฒญ์ ๋๋ค. *๊ฒฐ์ ๋ก ์ ์์ฒญ ์ํ์ค*์ ์๋ก๋ ํ์ด์ง ์์ ์ด ์์ต๋๋ค.
=> sentence distance : 249
โ line 221
โ The *logical entity* is a protocol neutral representation of a response. For HTTP, the logical entity may combine data from headers, body and the status line. A common example is exposing an
โ *๋ ผ๋ฆฌ์ ์ํฐํฐ*๋ ์๋ต์ ํ๋กํ ์ฝ ์ค๋ฆฝ์ ํํ์ ๋๋ค. HTTP์ ๊ฒฝ์ฐ, ๋ ผ๋ฆฌ์ ์ํฐํฐ๋ ํค๋, ๋ณธ๋ฌธ ๋ฐ ์ํ ํ์์ค์ ๋ฐ์ดํฐ๋ฅผ ๊ฒฐํฉํ ์ ์์ต๋๋ค. ์ผ๋ฐ์ ์ธ ์๋ก๋ ๋ณธ๋ฌธ์์ ์ญ์ง๋ ฌํ๋ ๋ด์ฉ ์ธ์๋
=> sentence distance : 160
โ line 221
โ header as a property on the logical entity in addition to any deserialized content from the body.
โ ํค๋๋ฅผ ๋ ผ๋ฆฌ์ ์ํฐํฐ์ ์์ฑ์ผ๋ก ๋ ธ์ถํ๋ ๊ฒ์ ๋๋ค.
=> sentence distance : 91
โ line 223
โ optimize for returning the logical entity for a given request. The logical entity must represent the information needed in the 99%+ case.
โ ์ฃผ์ด์ง ์์ฒญ์ ๋ํ ๋ ผ๋ฆฌ์ ์ํฐํฐ๋ฅผ ๋ฐํํ๋๋ก ์ต์ ํํ์ญ์์ค. ๋ ผ๋ฆฌ์ ์ํฐํฐ๋ 99% ์ด์์ ๊ฒฝ์ฐ์ ํ์ํ ์ ๋ณด๋ฅผ ๋ํ๋ด์ผ ํฉ๋๋ค.
=> sentence distance : 120
โ line 225
โ allow a consumer to access the complete response, including the status line, headers and body. The client library must follow the language specific guidance for accomplishing this.
โ ์๋น์๊ฐ ์ํ ํ์์ค, ํค๋ ๋ฐ ๋ณธ๋ฌธ์ ํฌํจํ์ฌ ์ ์ฒด ์๋ต์ ์ ๊ทผํ ์ ์๋๋ก ํ์ฉํ์ญ์์ค. ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ ์ด๋ฅผ ์ํํ๊ธฐ ์ํด ์ธ์ด๋ณ ์ง์นจ์ ๋ฐ๋ผ์ผ ํฉ๋๋ค.
=> sentence distance : 158
โ line 227
โ provide examples on how to access the raw and streamed response for a given request, where exposed by the client library. We do not expect all methods to expose a streamed response.
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ์ํด ๋ ธ์ถ๋๋ ์ฃผ์ด์ง ์์ฒญ์ ๋ํ ์์ ๋ฐ ์คํธ๋ฆผ ์๋ต์ ์ก์ธ์คํ๋ ๋ฐฉ๋ฒ์ ์์๋ฅผ ์ ๊ณตํ์ญ์์ค. ๋ชจ๋ ๋ฉ์๋๊ฐ ์คํธ๋ฆผ๋ ์๋ต์ ๋ ธ์ถํ ๊ฒ์ผ๋ก ๊ธฐ๋ํ์ง๋ ์์ต๋๋ค.
=> sentence distance : 158
โ line 229
โ provide a language idiomatic way to enumerate all logical entities for a paged operation, automatically fetching new pages as needed.
โ ํ์์ ๋ฐ๋ผ ์ ํ์ด์ง๋ฅผ ์๋์ผ๋ก ๊ฐ์ ธ์ค๋ ํ์ด์ง ์์ ์ ๋ํ ๋ชจ๋ ๋ ผ๋ฆฌ์ ์ํฐํฐ๋ฅผ ์ด๊ฑฐํ๋ ์ธ์ด ๊ด์ฉ์ ๋ฐฉ๋ฒ์ ์ ๊ณตํ์ญ์์ค.
=> sentence distance : 117
โ line 231
โ For example, in Python:
โ ์๋ฅผ ๋ค์ด, ํ์ด์ฌ์ ๋ค์๊ณผ ๊ฐ์ต๋๋ค:
=> sentence distance : 20
โ line 248
โ For methods that combine multiple requests into a single call:
โ ์ฌ๋ฌ ์์ฒญ์ ๋จ์ผ ํธ์ถ๋ก ๊ฒฐํฉํ๋ ๋ฉ์๋์ ๊ฒฝ์ฐ:
=> sentence distance : 55
โ line 250
โ return headers and other per-request metadata unless it is obvious as to which specific
โ ๋ฉ์๋ ๋ฐํ ๊ฐ์ด ์ด๋ค ํน์
=> sentence distance : 83
โ line 250
โ request the methods return value corresponds to.
โ ์์ฒญ์ ํด๋นํ๋์ง ๋ช ํํ์ง ์์ ๊ฒฝ์ฐ ํค๋ ๋ฐ ๊ธฐํ ์์ฒญ๋ณ ๋ฉํ๋ฐ์ดํฐ๋ฅผ ๋ฐํํ์ญ์์ค.
=> sentence distance : 45
โ line 252
โ provide enough information in failure cases for an application to take appropriate corrective action.
โ ์คํจ ์ ์ ํ๋ฆฌ์ผ์ด์ ์ด ์ ์ ํ ์์ ์กฐ์น๋ฅผ ์ทจํ ์ ์๋๋ก ์ถฉ๋ถํ ์ ๋ณด๋ฅผ ์ ๊ณตํ์ญ์์ค.
=> sentence distance : 89
โ line 254
โ use common reserved words as a property name within the models returned within the logical entity. For example:
โ ๋ ผ๋ฆฌ ์ํฐํฐ ๋ด์ ๋ฐํ๋ ๋ชจ๋ธ ๋ด์์ ๊ณตํต ์์ฝ ๋จ์ด๋ฅผ ์์ฑ ์ด๋ฆ์ผ๋ก ์ฌ์ฉํ๋ฉด ์ ๋ฉ๋๋ค. ์๋ฅผ ๋ค์ด:
=> sentence distance : 95
โ line 259
โ Such usage can cause confusion and will inevitably have to be changed on a per-language basis, which can cause consistency problems.
โ ์ด๋ฌํ ์ฌ์ฉ๋ฒ์ ํผ๋์ ์ผ์ผํฌ ์ ์์ผ๋ฉฐ, ์ธ์ด๋ณ๋ก ๋ฐ๋์ ๋ณ๊ฒฝํด์ผ ํ๋ฏ๋ก ์ผ๊ด์ฑ ๋ฌธ์ ๊ฐ ๋ฐ์ํ ์ ์์ต๋๋ค.
=> sentence distance : 117
โ line 261
โ Conditional requests
โ ์กฐ๊ฑด๋ถ ์์ฒญ
=> sentence distance : 19
โ line 263
โ [Conditional requests](https://developer.mozilla.org/en-US/docs/Web/HTTP/Conditional_requests) are normally performed using
โ [HTTP ์กฐ๊ฑด๋ถ ์์ฒญ](https://developer.mozilla.org/en-US/docs/Web/HTTP/Conditional_requests)์ ์ผ๋ฐ์ ์ผ๋ก
=> sentence distance : 47
โ line 263
โ headers. The primary usage provides headers that match the `ETag` to some known value. The `ETag` is an opaque identifier that represents a single version of a resource. For example, adding the following header will translate to "if the record's version, specified by the `ETag`, is not the same".
โ ํค๋๋ฅผ ์ฌ์ฉํ์ฌ ์ํ๋ฉ๋๋ค. ๊ธฐ๋ณธ ์ฌ์ฉ๋ฒ์ ์๋ ค์ง ๊ฐ์ `ETag`์ ์ผ์น์ํค๋ ํค๋๋ฅผ ์ ๊ณตํฉ๋๋ค. `ETag`๋ ๋จ์ผ ๋ฒ์ ์ ๋ฆฌ์์ค๋ฅผ ๋ํ๋ด๋ ๋ถํฌ๋ช ํ ์๋ณ์์ ๋๋ค. ์๋ฅผ ๋ค์ด ๋ค์ ํค๋๋ฅผ ์ถ๊ฐํ๋ฉด "`ETag`๋ก ์ง์ ๋ ๋ ์ฝ๋ ๋ฒ์ ์ด ๋์ผํ์ง ์์ ๊ฒฝ์ฐ"๋ก ๋ณํ๋ฉ๋๋ค.
=> sentence distance : 254
โ line 269
โ With headers, tests are possible for the following:
โ ํค๋๋ฅผ ์ฌ์ฉํ์ฌ ๋ค์์ ํ ์คํธํ ์ ์์ต๋๋ค:
=> sentence distance : 45
โ line 271
โ Unconditionally (no additional headers)
โ ์กฐ๊ฑด ์์ (์ถ๊ฐ ํค๋ ์์)
=> sentence distance : 34
โ line 272
โ If (not) modified since a version
โ ๋ฒ์ ์ดํ ์์ (์)ํ ๊ฒฝ์ฐ
=> sentence distance : 30
โ line 272
โ and
โ ๋ฐ
=> sentence distance : 3
โ line 273
โ If (not) modified since a date
โ ๋ ์ง ์ดํ ์์ (์)ํ ๊ฒฝ์ฐ
=> sentence distance : 27
โ line 273
โ and
โ ๋ฐ
=> sentence distance : 3
โ line 274
โ If (not) present (`If-Match` and `If-Not-Match` with a `ETag=*` value)
โ ์กด์ฌํ๋(ํ์ง ์๋) ๊ฒฝ์ฐ (`ETag=*` ๊ฐ์ด ์๋ `If-Match` ๋ฐ `If-Not-Match`)
=> sentence distance : 50
โ line 276
โ Not all services support all of these semantics, and may not support any of them. Developers have varying levels of understanding of the
โ ๋ชจ๋ ์๋น์ค๊ฐ ์ด๋ฌํ ์๋ฏธ ์ฒด๊ณ๋ฅผ ๋ชจ๋ ์ง์ํ๋ ๊ฒ์ ์๋๋ฉฐ, ์ด๋ ๊ฒ๋ ์ง์ํ์ง ์์ ์ ์์ต๋๋ค. ๊ฐ๋ฐ์๋
=> sentence distance : 122
โ line 276
โ and conditional requests, so it is best to abstract this concept from the
โ ๋ฐ ์กฐ๊ฑด๋ถ ์์ฒญ์ ๋ํ ์ดํด ์์ค์ด ๋ค์ํ๋ฏ๋ก
=> sentence distance : 67
โ line 276
โ surface. There are two types of conditional requests we need to be concerned with:
โ ํ๋ฉด์์ ์ด ๊ฐ๋ ์ ์ถ์ํํ๋ ๊ฒ์ด ๊ฐ์ฅ ์ข์ต๋๋ค. ์ฐ๋ฆฌ๊ฐ ๊ณ ๋ คํด์ผ ํ ์กฐ๊ฑด๋ถ ์์ฒญ์๋ ๋ ๊ฐ์ง ์ ํ์ด ์์ต๋๋ค.
=> sentence distance : 72
โ line 278
โ **Safe conditional requests** (e.g.
โ **์์ ํ(Safe) ์กฐ๊ฑด๋ถ ์์ฒญ** (์์:
=> sentence distance : 28
โ line 280
โ These are typically used to save bandwidth in an "update cache" scenario, i.e. I have a cached value, only send me the data if what the service has is newer than my copy. These return either a
โ ์ด๋ ์ผ๋ฐ์ ์ผ๋ก "์บ์ ์ ๋ฐ์ดํธ" ์๋๋ฆฌ์ค์์ ๋์ญํญ์ ์ ์ฝํ๋ ๋ฐ ์ฌ์ฉ๋ฉ๋๋ค. (์์: ๋์๊ฒ ์บ์๋ ๊ฐ์ด ์์ต๋๋ค. ์๋น์ค์ ์๋ ๋ฐ์ดํฐ๊ฐ ๋ด ๋ณต์ฌ๋ณธ๋ณด๋ค ์ต์ ์ธ ๊ฒฝ์ฐ์๋ง ๋ฐ์ดํฐ๋ฅผ ๋ณด๋ด์ฃผ์ญ์์ค.) ์ด ๊ฒฝ์ฐ ๊ฐ์ด ์์ ๋์ง ์์์์ ๋ํ๋ด๋
=> sentence distance : 166
โ line 280
โ or a
โ ๋๋
=> sentence distance : 4
โ line 280
โ status code, indicating the value was not modified, which tells the caller that their cached value is up to date.
โ ์ํ ์ฝ๋๊ฐ ๋ฐํ๋๋ฉฐ, ํธ์ถ์์๊ฒ ์บ์๋ ๊ฐ์ด ์ต์ ์ํ์์ ์ ์ ์์ต๋๋ค.
=> sentence distance : 101
โ line 282
โ **Unsafe conditional requests** (e.g.
โ **์์ ํ์ง ์์(Unsafe) ์กฐ๊ฑด๋ถ ์์ฒญ** (์์
=> sentence distance : 29
โ line 282
โ or
โ None
=> sentence distance : None
โ line 284
โ These are typically used to prevent losing updates in an optimistic concurrency scenario, i.e. I've modified the cached value I'm holding, but don't update the service version unless it has the same copy I've got. These return either a success or a
โ ์ด๋ ์ผ๋ฐ์ ์ผ๋ก ๋๊ด์ ๋์์ฑ(optimistic concurrency) ์๋๋ฆฌ์ค์์ ์ ๋ฐ์ดํธ ์์ค์ ๋ฐฉ์งํ๋ ๋ฐ ์ฌ์ฉ๋ฉ๋๋ค. (์์: ๋๋ ํ์ฌ ๋ณด์ ํ๊ณ ์๋ ์บ์๋ ๊ฐ์ ์์ ํ์ต๋๋ค. ํ์ง๋ง ๋์ผํ ๋ณต์ฌ๋ณธ์ด ์์ผ๋ฉด ์๋น์ค ๋ฒ์ ์ ์ ๋ฐ์ดํธํ์ง ๋ง์ญ์์ค.) ์ด ๊ฒฝ์ฐ ์ฑ๊ณต ํน์ ๊ฐ์ด ์์ ๋์์์ ๋ํ๋ด๋
=> sentence distance : 200
โ line 284
โ error status code, indicating the value was modified, to indicate to the caller that they'll need to retry their update if they want it to succeed.
โ ์ค๋ฅ ์ํ ์ฝ๋๋ฅผ ๋ฐํํ์ฌ, ํธ์ถ์์๊ฒ ์ ๋ฐ์ดํธ๊ฐ ์ฑ๊ณตํ๋ ค๋ฉด ์ ๋ฐ์ดํธ๋ฅผ ๋ค์ ์๋ํด์ผ ํจ์ ๋ํ๋ ๋๋ค.
=> sentence distance : 134
โ line 286
โ These two cases are handled differently in client libraries. However, the form of the call is the same in both cases. The signature of the method should be:
โ ์ด ๋ ๊ฒฝ์ฐ๋ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์์ ๋ค๋ฅด๊ฒ ์ฒ๋ฆฌ๋ฉ๋๋ค. ๊ทธ๋ฌ๋ ํธ์ถ ํ์์ ๋ ๊ฒฝ์ฐ ๋ชจ๋ ๋์ผํฉ๋๋ค. ๋ฉ์๋์ ์๋ช ์ ๋ค์๊ณผ ๊ฐ์์ผ ํฉ๋๋ค:
=> sentence distance : 137
โ line 292
โ field provides preconditions to the
โ ํ๋๋
=> sentence distance : 35
โ line 292
โ request. The
โ ์์ฒญ์ ๋ํ ์ ์ ์กฐ๊ฑด์ ์ ๊ณตํฉ๋๋ค.
=> sentence distance : 18
โ line 292
โ value will be retrieved from the item that is passed into the method where possible, and method arguments where not possible. The form of the method will be modified based on idiomatic usage patterns in the language of choice. In cases where the
โ ๊ฐ์ ๊ฐ๋ฅํ ๊ฒฝ์ฐ ๋ฉ์๋์ ์ ๋ฌ๋ ํญ๋ชฉ์์ ๊ฒ์๋๊ณ , ๋ถ๊ฐ๋ฅํ ๊ฒฝ์ฐ ๋ฉ์๋ ์ธ์์์ ๊ฒ์๋ฉ๋๋ค. ๋ฉ์๋์ ํ์์ ์ ํํ ์ธ์ด์ ๊ด์ฉ์ ์ฌ์ฉ ํจํด์ ๊ธฐ๋ฐ์ผ๋ก ์์ ๋ฉ๋๋ค.
=> sentence distance : 224
โ line 292
โ None
โ ๊ฐ์ ๋ชจ๋ฅด๋ ๊ฒฝ์ฐ ์์ ์ ์กฐ๊ฑด๋ถ์ผ ์ ์์ต๋๋ค.
=> sentence distance : None
โ line 293
โ value is not known, the operation cannot be conditional.
โ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ๊ฐ๋ฐ์๊ฐ ์ฌ์ ์กฐ๊ฑด ํค๋์ ๊ณ ๊ธ ์ฌ์ฉ์ ์ง์ํ ํ์๊ฐ ์๋ ๊ฒฝ์ฐ, ์กฐ๊ฑด์ ์ค์ ํ๊ธฐ ์ํด true๋ก ์ค์ ๋ ๋ถ์ธ(boolean) ๋งค๊ฐ๋ณ์๋ฅผ ์ถ๊ฐํ ์ ์์ต๋๋ค. ์๋ฅผ ๋ค์ด, ์กฐ๊ฑด ์ฐ์ฐ์ ๋์ ๋ค์ ๋ถ์ธ ์ด๋ฆ ์ค ํ๋๋ฅผ ์ฌ์ฉํฉ๋๋ค.
=> sentence distance : 120
โ line 301
โ In all cases, the conditional expression is "opt-in", and the default is to perform the operation unconditionally.
โ ๋ชจ๋ ๊ฒฝ์ฐ์ ์กฐ๊ฑด์์ "์ตํธ์ธ(opt-in)"์ด๋ฉฐ ๊ธฐ๋ณธ๊ฐ์ ์์ ์ ๋ฌด์กฐ๊ฑด ์ํํ๋ ๊ฒ์ ๋๋ค.
=> sentence distance : 99
โ line 303
โ The return value from a conditional operation must be carefully considered. For safe operators (e.g. GET), return a response that will throw if the value is accessed (or follow the same convention used fro a
โ ์กฐ๊ฑด๋ถ ์ฐ์ฐ์ ๋ฐํ ๊ฐ์ ์ ์คํ๊ฒ ๊ณ ๋ คํด์ผ ํฉ๋๋ค. ์์ ํ ์ฐ์ฐ์(์: GET)์ ๊ฒฝ์ฐ ๋ณธ๋ฌธ์ ์ฐธ์กฐํ ๊ฐ์ด ์์ผ๋ฏ๋ก, ๊ฐ์ ์ ๊ทผํ๋ฉด(๋๋
=> sentence distance : 185
โ line 303
โ response), since there is no value in the body to reference. For unsafe operators (e.g.
โ ์๋ต์ ์ฌ์ฉ๋ ๊ฒ๊ณผ ๋์ผํ ๊ท์น์ ๋ฐ๋ฆ) ๋์ ธ์ง๋ ์๋ต์ ๋ฐํํฉ๋๋ค. ์์ ํ์ง ์์ ์ฐ์ฐ์(์:
=> sentence distance : 76
โ line 303
โ DELETE, or POST), throw a specific error when a
โ DELETE ๋๋ POST)์ ๊ฒฝ์ฐ
=> sentence distance : 33
โ line 303
โ or
โ ๋๋
=> sentence distance : 2
โ line 303
โ result is received. This allows the consumer to do something different in the case of conflicting results.
โ ๊ฒฐ๊ณผ๊ฐ ์์ ๋๋ฉด ํน์ ์ค๋ฅ๋ฅผ ๋ฐ์์ํต๋๋ค. ์ด๋ ๊ฒ ํ๋ฉด ๊ฒฐ๊ณผ๊ฐ ์ถฉ๋๋๋ ๊ฒฝ์ฐ ์๋น์๊ฐ ๋ค๋ฅธ ์์ ์ ์ํํ ์ ์์ต๋๋ค.
=> sentence distance : 94
โ line 305
โ accept a
โ ์๋น์ค์ ๋ํ ์กฐ๊ฑด๋ถ ๊ฒ์ฌ๋ฅผ ํ์ฉํ๋ ์๋น์ค ๋ฉ์๋์ ๋ํ (์ด๊ฑฐํ ์ ํ์)
=> sentence distance : 41
โ line 305
โ parameter (which takes an enumerated type) on service methods that allow a conditional check on the service.
โ ๋งค๊ฐ๋ณ์๋ฅผ ์๋ฝํด์ผ ํฉ๋๋ค.
=> sentence distance : 105
โ line 307
โ accept an additional boolean or enum parameter on service methods as necessary to enable conditional checks using `ETag`.
โ `ETag`๋ฅผ ์ฌ์ฉํ์ฌ ์กฐ๊ฑด๋ถ ๊ฒ์ฌ๋ฅผ ํ์ฑํํ๋ ค๋ฉด ํ์์ ๋ฐ๋ผ ์๋น์ค ๋ฉ์๋์ ๋ํ ์ถ๊ฐ ๋ถ์ธ ๋๋ ์ด๊ฑฐํ ๋งค๊ฐ๋ณ์๋ฅผ ์๋ฝํด์ผ ํฉ๋๋ค.
=> sentence distance : 105
โ line 309
โ include the
โ ์กฐ๊ฑด๋ถ ์ฐ์ฐ์ด ์ง์๋๋ ๊ฒฝ์ฐ
=> sentence distance : 14
โ line 309
โ field as part of the object model when conditional operations are supported.
โ ํ๋๋ฅผ ๊ฐ์ฒด ๋ชจ๋ธ์ ์ผ๋ถ๋ก ํฌํจํด์ผ ํฉ๋๋ค.
=> sentence distance : 70
โ line 311
โ throw an error when a
โ ์๋น์ค๋ก๋ถํฐ
=> sentence distance : 21
โ line 311
โ response is received from the service, unless such errors are idiomatic to the language.
โ ์๋ต์ด ์์ ๋์์ ๋, ์ด๋ฌํ ์ค๋ฅ๊ฐ ์ธ์ด์ ๊ด์ฉ์ ์ด์ง ์์ ํ ์ค๋ฅ๋ฅผ ๋ฐ์์์ผ์๋ ์ ๋ฉ๋๋ค.
=> sentence distance : 76
โ line 313
โ throw a distinct error when a
โ ์กฐ๊ฑด๋ถ ํ์ธ์ผ๋ก ์ธํด ์๋น์ค๋ก๋ถํฐ
=> sentence distance : 26
โ line 313
โ response or a
โ ์๋ต ๋๋
=> sentence distance : 12
โ line 313
โ response is received from the service due to a conditional check.
โ ์๋ต์ด ์์ ๋๋ฉด ๊ณ ์ ํ ์ค๋ฅ๋ฅผ ๋ฐ์์์ผ์ผ ํฉ๋๋ค.
=> sentence distance : 59
โ line 315
โ Pagination
โ ํ์ด์ง ๋งค๊น(Pagination)
=> sentence distance : 8
โ line 317
โ client libraries eschew low-level pagination APIs in favor of high-level abstractions that implement per-item iterators. High-level APIs are easy for developers to use for the majority of use cases but can be more confusing when finer-grained control is required (for example, over-quota/throttling) and debugging when things go wrong. Other guidelines in this document work to mitigate this limitation, for example by providing robust logging, tracing, and pipeline customization options.
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ ํญ๋ชฉ๋ณ ๋ฐ๋ณต๊ธฐ(iterator)๋ฅผ ๊ตฌํํ๋ ๋์ ์์ค์ ์ถ์ํ๋ฅผ ์ํด ๋ฎ์ ์์ค์ ํ์ด์ง ๋งค๊น API๋ฅผ ์ฌ์ฉํ์ง ์์ต๋๋ค. ๊ณ ์์ค API๋ ๋๋ถ๋ถ์ ์ฌ์ฉ ์ฌ๋ก์ ๋ํด ๊ฐ๋ฐ์๊ฐ ์ฌ์ฉํ๊ธฐ ์ฝ์ง๋ง, ๋ณด๋ค ์ธ๋ถํ๋ ์ ์ด(์์: ํ ๋น๋ ์ด๊ณผ/์ ํ)๊ฐ ํ์ํ ๋ ๊ทธ๋ฆฌ๊ณ ๋ฌธ์ ๊ฐ ๋ฐ์ํ์ฌ ๋๋ฒ๊น ์ด ํ์ํ ๋ ๋ ํผ๋์ค๋ฌ์ธ ์ ์์ต๋๋ค. ์ด ๋ฌธ์์ ๋ค๋ฅธ ์ง์นจ์ ์๋ฅผ ๋ค์ด ๊ฐ๋ ฅํ ๋ก๊น , ์ถ์ ๋ฐ ํ์ดํ๋ผ์ธ ์ฌ์ฉ์ ์ง์ ์ต์ ์ ์ ๊ณตํ์ฌ ์ด๋ฌํ ์ ํ์ ์ํํฉ๋๋ค.
=> sentence distance : 423
โ line 319
โ expose paginated collections using language-canonical iterators over items within pages. The APIs used to expose the async iterators are language-dependent but should align with any existing common practices in your ecosystem.
โ ํ์ด์ง ๋ด์ ํญ๋ชฉ์ ๋ํด ์ธ์ด ํ์ค ๋ฐ๋ณต์๋ฅผ ์ฌ์ฉํ์ฌ ํ์ด์ง๋ฅผ ๋งค๊ธด ์ปฌ๋ ์ ์ ๋ ธ์ถํ์ญ์์ค. ๋น๋๊ธฐ ๋ฐ๋ณต๊ธฐ๋ฅผ ๋ ธ์ถํ๋ ๋ฐ ์ฌ์ฉ๋๋ API๋ ์ธ์ด์ ๋ฐ๋ผ ๋ค๋ฅด์ง๋ง, ์์ฝ์์คํ ์ ๊ธฐ์กด ์ผ๋ฐ์ ์ธ ๊ดํ๊ณผ ์ผ์นํด์ผ ํฉ๋๋ค.
=> sentence distance : 200
โ line 321
โ expose paginated collections using an iterator or cursor pattern if async iterators aren't a built-in feature of your language.
โ ๋น๋๊ธฐ ๋ฐ๋ณต๊ธฐ๊ฐ ํด๋น ์ธ์ด์ ๊ธฐ๋ณธ ๊ธฐ๋ฅ์ด ์๋ ๊ฒฝ์ฐ, ๋ฐ๋ณต๊ธฐ ๋๋ ์ปค์ ํจํด์ ์ฌ์ฉํ์ฌ ํ์ด์ง๊ฐ ๋งค๊ฒจ์ง ์ปฌ๋ ์ ์ ๋ ธ์ถํ์ญ์์ค.
=> sentence distance : 110
โ line 323
โ expose non-paginated list endpoints identically to paginated list endpoints. Users shouldn't need to appreciate the difference.
โ ํ์ด์ง๊ฐ ๋งค๊ฒจ์ง์ง ์์ ๋ชฉ๋ก ๋์ ์ ํ์ด์ง๊ฐ ๋งค๊ฒจ์ง ๋ชฉ๋ก ๋์ ๊ณผ ๋์ผํ๊ฒ ๋ ธ์ถํ์ญ์์ค. ์ฌ์ฉ์๋ ๊ทธ ์ฐจ์ด๋ฅผ ์ธ์ํ ํ์๊ฐ ์์ต๋๋ค.
=> sentence distance : 111
โ line 325
โ use distinct types for entities in a list endpoint and an entity returned from a get endpoint if these are different types, and otherwise you must use the same types in these situations.
โ ๋ชฉ๋ก ๋์ ์ ์ํฐํฐ์ ๊ฐ์ ธ์ค๊ธฐ(get) ๋์ ์์ ๋ฐํ๋ ์ํฐํฐ๊ฐ ์๋ก ๋ค๋ฅธ ์ ํ์ธ ๊ฒฝ์ฐ ๊ณ ์ ํ ์ ํ์ ์ฌ์ฉํ๊ณ , ๊ทธ๋ ์ง ์์ผ๋ฉด ์ด๋ฌํ ์ํฉ์์ ๋์ผํ ์ ํ์ ์ฌ์ฉํด์ผ ํฉ๋๋ค.
=> sentence distance : 161
โ line 327
โ content="Services should refrain from having a difference between the type of a particular entity as it exists in a list versus the result of a
โ content="์๋น์ค๋ ๋ชฉ๋ก์ ์กด์ฌํ๋ ํน์ ์ํฐํฐ ํ์๊ณผ ํด๋น ๊ฐ๋ณ ํญ๋ชฉ์ ๋ํ
=> sentence distance : 125
โ line 327
โ request for that individual item as it makes the client library's surface area simpler."
โ ์์ฒญ์ ๊ฒฐ๊ณผ ๊ฐ์ ์ฐจ์ด๊ฐ ๋ฐ์ํ์ง ์๋๋ก ํด์ผ ํ๋๋ฐ, ์ด๋ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ๋ ธ์ถ ์์ญ์ ๋์ฑ ๋จ์ํ๊ฒ ๋ง๋ค๊ธฐ ๋๋ฌธ์ ๋๋ค."
=> sentence distance : 75
โ line 329
โ expose an iterator over each individual item if getting each item requires a corresponding
โ ๊ฐ ํญ๋ชฉ์ ๊ฐ์ ธ์ค๋ ค๋ฉด ํด๋น
=> sentence distance : 87
โ line 329
โ request to the service. One GET per item is often too expensive and so not an action we want to take on behalf of users.
โ ์์ฒญ์ด ์๋น์ค์ ํ์ํ ๊ฒฝ์ฐ ๊ฐ ๊ฐ๋ณ ํญ๋ชฉ์ ๋ํด ๋ฐ๋ณต๊ธฐ๋ฅผ ๋ ธ์ถํ์ง ๋ง์ญ์์ค. ํญ๋ชฉ๋น ํ๋์ GET๋ ๋๋ฌด ๋น์ธ๊ธฐ ๋๋ฌธ์ ์ฌ์ฉ์๋ฅผ ๋์ ํ์ฌ ์ํํ ์์ ์ด ์๋๋๋ค.
=> sentence distance : 102
โ line 331
โ expose an API to get a paginated collection into an array. This is a dangerous capability for services which may return many pages.
โ ํ์ด์ง๊ฐ ๋งค๊ฒจ์ง ์ปฌ๋ ์ ์ ๋ฐฐ์ด๋ก ๊ฐ์ ธ์ค๊ธฐ ์ํด API๋ฅผ ๋ ธ์ถํ์ง ๋ง์ญ์์ค. ์ด๋ ์ฌ๋ฌ ํ์ด์ง๋ฅผ ๋ฐํํ ์ ์๋ ์๋น์ค์ ์ํํ ๊ธฐ๋ฅ์ ๋๋ค.
=> sentence distance : 114
โ line 333
โ expose paging APIs when iterating over a collection. Paging APIs must accept a continuation token (from a prior run) and a maximum number of items to return, and must return a continuation token as part of the response so that the iterator may continue, potentially on a different machine.
โ ์ปฌ๋ ์ ์ ๋ฐ๋ณตํ ๋ ํ์ด์ง API๋ฅผ ๋ ธ์ถํ์ญ์์ค. ํ์ด์ง API๋ (์ด์ ์คํ์์ ๋ฐํํ ) ์ฐ์ ํ ํฐ๊ณผ ์ต๋ ํญ๋ชฉ ์๋ฅผ ์๋ฝํด์ผ ํ๋ฉฐ, ๋ฐ๋ณต๊ธฐ๊ฐ ์ ์ฌ์ ์ผ๋ก ๋ค๋ฅธ ์์คํ ์์ ๊ณ์๋ ์ ์๋๋ก ์๋ต์ ์ผ๋ถ๋ก ์ฐ์ ํ ํฐ์ ๋ฐํํด์ผ ํฉ๋๋ค.
=> sentence distance : 252
โ line 335
โ Long running operations
โ ์ฅ๊ธฐ ์คํ ์์
=> sentence distance : 21
โ line 337
โ Long-running operations are operations which consist of an initial request to start the operation followed by polling to determine when the operation has completed or failed. Long-running operations in Azure tend to follow the [REST
โ ์ฅ๊ธฐ ์คํ ์์ ์ ์์ ์ ์์ํ๊ธฐ ์ํ ์ด๊ธฐ ์์ฒญ๊ณผ ์์ ์ด ์๋ฃ๋์๋์ง ๋๋ ์คํจํ๋์ง ์ฌ๋ถ๋ฅผ ํ์ธํ๊ธฐ ์ํ ํด๋ง์ ์ด์ ์์ ์ผ๋ก ๊ตฌ์ฑ๋ฉ๋๋ค. Azure์ ์ฅ๊ธฐ ์คํ ์์ ์ [์ฅ๊ธฐ ์คํ ์์ ์ ๋ํ REST
=> sentence distance : 199
โ line 337
โ guidelines for Long-running Operations][rest-lro], but there are exceptions.
โ ์ง์นจ][rest-lro]์ ๋ฐ๋ฅด๋ ๊ฒฝํฅ์ด ์์ง๋ง ์์ธ๊ฐ ์์ต๋๋ค.
=> sentence distance : 60
โ line 339
โ represent long-running operations with some object that encapsulates the polling and the operation status. This object, called a *poller*, must provide APIs for:
โ ํด๋ง ๋ฐ ์์ ์ํ๋ฅผ ์บก์ํํ๋ ์ผ๋ถ ๊ฐ์ฒด๋ก ์ฅ๊ธฐ ์คํ ์์ ์ ๋ํ๋ด์ญ์์ค. *poller*๋ผ๊ณ ํ๋ ์ด ๊ฐ์ฒด๋ ๋ค์์ ๋ํ API๋ฅผ ์ ๊ณตํด์ผ ํฉ๋๋ค:
=> sentence distance : 138
โ line 341
โ querying the current operation state (either asynchronously, which may consult the service, or synchronously which must not)
โ ํ์ฌ ์์ ์ํ ์ฟผ๋ฆฌ (์๋น์ค๋ฅผ ์ฐธ์กฐํ ์ ์๋ ๋น๋๊ธฐ์ ๋๋ ๋๊ธฐํํด์๋ ์ ๋๋ ๋น๋๊ธฐ์)
=> sentence distance : 109
โ line 342
โ requesting an asynchronous notification when the operation has completed
โ ์์ ์ด ์๋ฃ๋์์ ๋ ๋น๋๊ธฐ ์๋ฆผ ์์ฒญ
=> sentence distance : 67
โ line 343
โ cancelling the operation if cancellation is supported by the service
โ ์๋น์ค์์ ์ทจ์๋ฅผ ์ง์ํ๋ ๊ฒฝ์ฐ ์์ ์ทจ์
=> sentence distance : 63
โ line 344
โ registering disinterest in the operation so polling stops
โ ํด๋ง์ด ์ค์ง๋๋๋ก ์์ ์ ๋ฌด๊ด์ฌ ๋ฑ๋ก
=> sentence distance : 53
โ line 345
โ triggering a poll operation manually (automatic polling must be disabled)
โ ์๋์ผ๋ก ํด๋ง ์์ ํธ๋ฆฌ๊ฑฐ (์๋ ํด๋ง์ ๋นํ์ฑํํด์ผ ํจ)
=> sentence distance : 64
โ line 346
โ progress reporting (if supported by the service)
โ ์งํ ์ํฉ ๋ณด๊ณ (์๋น์ค์์ ์ง์ํ๋ ๊ฒฝ์ฐ)
=> sentence distance : 42
โ line 348
โ support the following polling configuration options:
โ ๋ค์ ํด๋ง ๊ตฌ์ฑ ์ต์ ์ ์ง์ํ์ญ์์ค:
=> sentence distance : 47
โ line 352
โ Polling configuration may be used only in the absence of relevant retry-after headers from service, and otherwise should be ignored.
โ ํด๋ง ๊ตฌ์ฑ์ ์๋น์ค์์ ๊ด๋ จ ์ฌ์๋ ํ ํค๋๊ฐ ์๋ ๊ฒฝ์ฐ์๋ง ์ฌ์ฉํ ์ ์์ผ๋ฉฐ, ๊ทธ๋ ์ง ์์ ๊ฒฝ์ฐ ๋ฌด์ํด์ผ ํฉ๋๋ค.
=> sentence distance : 115
โ line 354
โ or `start`. Language-specific guidelines will dictate which verb to use.
โ ๋๋ `start`๋ฅผ ์ฌ์ฉํ์ฌ ํด๋ฌ๋ฅผ ๋ฐํํ๋ ์ ๋์ฌ ๋ฉ์๋ ์ด๋ฆ์ ์ง์ ํ์ญ์์ค. ์ธ์ด๋ณ ์ง์นจ์ ๋ฐ๋ผ ์ฌ์ฉํ ๋์ฌ๊ฐ ์ง์ ๋ฉ๋๋ค.
=> sentence distance : 59
โ line 354
โ prefix method names which return a poller with either
โ None
=> sentence distance : None
โ line 356
โ provide a way to instantiate a poller with the serialized state of another poller to begin where it left off, for example by passing the state as a parameter to the same method which started the operation, or by directly instantiating a poller with that state.
โ ๋ค๋ฅธ ํด๋ฌ์ ์ง๋ ฌํ๋ ์ํ๋ก ํด๋ฌ๋ฅผ ์ธ์คํด์คํํ๋ ๋ฐฉ๋ฒ์ ์ ๊ณตํ์ญ์์ค. ์๋ฅผ ๋ค์ด ์ํ๋ฅผ ์์ ์ ์์ํ ๋์ผํ ๋ฉ์๋์ ๋งค๊ฐ๋ณ์๋ก ์ ๋ฌํ๊ฑฐ๋ ํด๋น ์ํ๋ก ํด๋ฌ๋ฅผ ์ง์ ์ธ์คํด์คํํ์ฌ ์ค๋จ๋ ์์น์์ ์์ํฉ๋๋ค.
=> sentence distance : 235
โ line 358
โ cancel the long-running operation when cancellation is requested via a cancellation token. The cancellation token is cancelling the polling operation and should not have any effect on the service.
โ ์ทจ์ ํ ํฐ์ ํตํด ์ทจ์๋ฅผ ์์ฒญํ ๊ฒฝ์ฐ ์ฅ๊ธฐ ์คํ ์์ ์ ์ทจ์ํ์ง ๋ง์ญ์์ค. ์ทจ์ ํ ํฐ์ด ํด๋ง ์์ ์ ์ทจ์ํ๊ณ ์์ผ๋ฏ๋ก ์๋น์ค์ ์ํฅ์ ๋ฏธ์น์ง ์์์ผ ํฉ๋๋ค.
=> sentence distance : 173
โ line 360
โ level (including time to next retry)
โ ์์ค์์ ํด๋ง ์ํ๋ฅผ ๊ธฐ๋กํ์ญ์์ค(๋ค์ ์ฌ์๋ ์๊ฐ ํฌํจ).
=> sentence distance : 33
โ line 360
โ log polling status at the
โ None
=> sentence distance : None
โ line 362
โ expose a progress reporting mechanism to the consumer if the service reports progress as part of the polling operation. Language-dependent guidelines will present additional guidance on how to expose progress reporting in this case.
โ ์๋น์ค๊ฐ ํด๋ง ์์ ์ ์ผ๋ถ๋ก ์งํ ์ํฉ์ ๋ณด๊ณ ํ๋ ๊ฒฝ์ฐ, ์งํ๋ฅ ๋ณด๊ณ ๋ฉ์ปค๋์ฆ์ ์๋น์์๊ฒ ๋ ธ์ถํ์ญ์์ค. ์ธ์ด ์์กด์ ์ง์นจ์ ์ด ๊ฒฝ์ฐ์ ์งํ ์ํฉ ๋ณด๊ณ ๋ฅผ ๋ ธ์ถํ๋ ๋ฐฉ๋ฒ์ ๋ํ ์ถ๊ฐ ์ง์นจ์ ์ ์ํฉ๋๋ค.
=> sentence distance : 206
โ line 364
โ Support for non-HTTP protocols
โ HTTP๊ฐ ์๋ ํ๋กํ ์ฝ ์ง์
=> sentence distance : 27
โ line 366
โ Most
โ ๋๋ถ๋ถ์
=> sentence distance : 4
โ line 366
โ services expose a
โ ์๋น์ค๋ HTTPS๋ฅผ ํตํด
=> sentence distance : 16
โ line 366
โ API over HTTPS. However, a few services use other protocols, such as
โ API๋ฅผ ๋ ธ์ถํฉ๋๋ค. ๊ทธ๋ฌ๋ ์ผ๋ถ ์๋น์ค๋
=> sentence distance : 61
โ line 366
โ or [WebRTC](https://webrtc.org/). In these cases, the operation of the protocol can be split into two phases:
โ ๋๋ [WebRTC](https://webrtc.org/)์ ๊ฐ์ ๋ค๋ฅธ ํ๋กํ ์ฝ์ ์ฌ์ฉํฉ๋๋ค. ์ด๋ฌํ ๊ฒฝ์ฐ ํ๋กํ ์ฝ ์๋์ ๋ ๋จ๊ณ๋ก ๋๋ ์ ์์ต๋๋ค:
=> sentence distance : 66
โ line 368
โ Per-connection (surrounding when the connection is initiated and terminated)
โ ์ฐ๊ฒฐ๋ณ(per-connection, ์ฐ๊ฒฐ ์์ํ๊ณ ์ข ๋ฃ๋ ๋๋ฅผ ๋๋ฌ์)
=> sentence distance : 60
โ line 369
โ Per-operation (surrounding when an operation is sent through the open connection)
โ ์์ ๋ณ(per-operation, ์ด๋ฆฐ ์ฐ๊ฒฐ์ ํตํด ์์ ์ด ์ ์ก๋ ๋๋ฅผ ๋๋ฌ์)
=> sentence distance : 63
โ line 371
โ request/response (authentication, unique request
โ ์์ฒญ/์๋ต์ ์ถ๊ฐ๋ ์ ์ฑ (์ธ์ฆ, ๊ณ ์ ํ ์์ฒญ
=> sentence distance : 43
โ line 371
โ telemetry, distributed tracing, and logging) are still valid on both a per-connection and per-operation basis. However, the methods by which these policies are implemented are protocol dependent.
โ ์๊ฒฉ ์ธก์ , ๋ถ์ฐ ์ถ์ ๋ฐ ๋ก๊น )์ ์ฌ์ ํ ์ฐ๊ฒฐ๋ณ ๋ฐ ์์ ๋ณ๋ก ๋ชจ๋ ์ ํจํฉ๋๋ค. ๊ทธ๋ฌ๋ ์ด๋ฌํ ์ ์ฑ ์ ๊ตฌํํ๋ ๋ฐฉ๋ฒ์ ํ๋กํ ์ฝ์ ๋ฐ๋ผ ๋ค๋ฆ ๋๋ค.
=> sentence distance : 174
โ line 373
โ implement as many of the policies as possible on a per-connection and per-operation basis.
โ ์ฐ๊ฒฐ ๋ฐ ์์ ๋ณ๋ก ๊ฐ๋ฅํ ํ ๋ง์ ์ ์ฑ ์ ๊ตฌํํ์ญ์์ค.
=> sentence distance : 82
โ line 375
โ For example, MQTT over
โ ์๋ฅผ ๋ค์ด WebSockets๋ฅผ ํตํ MQTT๋
=> sentence distance : 22
โ line 375
โ provides the ability to add headers during the initiation of the WebSockets connection, so this is a good place to add authentication, telemetry, and distributed tracing policies. However, MQTT has no metadata (the equivalent of HTTP headers), so per-operation policies are not possible. AMQP, by contract, does have per-operation metadata. Unique request ID, and distributed tracing headers can be provided on a per-operation basis with AMQP.
โ ์ฐ๊ฒฐ์ ์์ํ๋ ๋์ ํค๋๋ฅผ ์ถ๊ฐํ ์ ์๋ ๊ธฐ๋ฅ์ ์ ๊ณตํ๋ฏ๋ก, ์ธ์ฆ, ์๊ฒฉ ์ธก์ ๋ฐ ๋ถ์ฐ ์ถ์ ์ ์ฑ ์ ์ถ๊ฐํ๊ธฐ์ ์ข์ต๋๋ค. ๊ทธ๋ฌ๋ MQTT์๋ (HTTP ํค๋์ ๋์ผํ) ๋ฉํ๋ฐ์ดํฐ๊ฐ ์์ผ๋ฏ๋ก ์์ ๋ณ ์ ์ฑ ์ด ๋ถ๊ฐ๋ฅํฉ๋๋ค. AMQP๋ ๊ณ์ฝ์ ๋ฐ๋ผ ์์ ๋ณ ๋ฉํ๋ฐ์ดํฐ๋ฅผ ๊ฐ์ง๊ณ ์์ต๋๋ค. AMQP๋ฅผ ์ฌ์ฉํ์ฌ ์์ ๋ณ๋ก ๊ณ ์ ์์ฒญ ID ๋ฐ ๋ถ์ฐ ์ถ์ ํค๋๋ฅผ ์ ๊ณตํ ์ ์์ต๋๋ค.
=> sentence distance : 381
โ line 377
โ consult the
โ HTTP๊ฐ ์๋ ํ๋กํ ์ฝ์ ๋ํ ์ ์ฑ ๊ฒฐ์ ์ ๋ํด์๋
=> sentence distance : 28
โ line 377
โ Board] on policy decisions for non-HTTP protocols. Implementation of all policies is expected. If the protocol cannot support a policy, obtain an exception from the
โ Board]์ ๋ฌธ์ํ์ญ์์ค. ๋ชจ๋ ์ ์ฑ ์ ๊ตฌํ์ด ๊ธฐ๋๋ฉ๋๋ค. ํ๋กํ ์ฝ์ด ์ ์ฑ ์ ์ง์ํ ์ ์๋ ๊ฒฝ์ฐ
=> sentence distance : 147
โ line 377
โ Board].
โ Board]์์ ์์ธ๋ฅผ ์ป์ต๋๋ค.
=> sentence distance : 11
โ line 379
โ library to configure policies for non-HTTP protocols. Consumers don't necessarily know what protocol is used by the client library. They will expect the client library to honor global configuration that they have established for the entire
โ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ์ค์ ๋ ์ ์ญ ๊ตฌ์ฑ์ ์ฌ์ฉํ์ฌ HTTP๊ฐ ์๋ ํ๋กํ ์ฝ์ ๋ํ ์ ์ฑ ์ ๊ตฌ์ฑํ์ญ์์ค. ์๋น์๋ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์์ ์ด๋ค ํ๋กํ ์ฝ์ ์ฌ์ฉํ๋์ง ๋ฐ๋์ ์ ํ์๋ ์์ต๋๋ค. ์ด๋ค์ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๊ฐ ์ ์ฒด
=> sentence distance : 214
โ line 379
โ SDK.
โ SDK์ ๋ํด ์ค์ ํ ์ ์ญ ๊ตฌ์ฑ์ ์ค์ํ ๊ฒ์ผ๋ก ์์ํฉ๋๋ค.
=> sentence distance : 29
โ line 379
โ use the global configuration established in the
โ None
=> sentence distance : None
</details>4120 words added. 3117 words deleted.
Added words rate 108.19327731092436% (4120 / 3808 words)
Deleted words rate 81.85399159663865% (3117 / 3808 words)
-
documentation.md : File Modified +537 / -416 ๐ 488
โ line 2
โ "General Guidelines: Documentation"
โ "๊ณตํต ๊ฐ์ด๋๋ผ์ธ: ์ค๋ช ์"
=> sentence distance : 30
โ line 9
โ There are several documentation deliverables that must be included in or as a companion to your client library. Beyond complete and helpful
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ๋ฐ๋์ ํฌํจ๋๊ฑฐ๋ ํจ๊ป ์ ๊ณต๋ผ์ผ ํ๋ ๋ช ๊ฐ์ง์ ๋ฌธ์๋ค์ด ์์ต๋๋ค. ์ฝ๋ ๋ด(Docstrings)์ ํฌํจ๋ ์์ ํ๊ณ ์ ์ฉํ
=> sentence distance : 121
โ line 9
โ documentation within the code itself (docstrings), you need a great
โ ์ค๋ช ์ ์ธ์๋, ํ๋ฅญํ
=> sentence distance : 64
โ line 9
โ and other supporting documentation.
โ ๋ฐ ๊ธฐํ ์ง์ ์ค๋ช ๋ค์ด ํ์ํฉ๋๋ค.
=> sentence distance : 31
โ line 11
โ repository; includes package installation and client library usage information. ([example][README-EXAMPLE])
โ ์ ์ฅ์ ๋ด ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ๋ฃจํธ ๋๋ ํ ๋ฆฌ์ ์์นํฉ๋๋ค; ํจํค์ง ์ค์น, ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์ฌ์ฉ ์ ๋ณด๊ฐ ํฌํจํฉ๋๋ค. ([์์][README-EXAMPLE])
=> sentence distance : 78
โ line 12
โ reference`
โ ์ฐธ์กฐ`
=> sentence distance : 9
โ line 12
โ Generated from the docstrings in your code; published on docs.microsoft.com.
โ ์ฝ๋ ๋ด์ Docstrings์์ ์์ฑ๋ฉ๋๋ค; docs.microsoft.com์ ๊ฒ์๋ฉ๋๋ค.
=> sentence distance : 50
โ line 13
โ `Code snippets`
โ `์ฝ๋ ์กฐ๊ฐ`
=> sentence distance : 12
โ line 13
โ Short code examples that demonstrate single (atomic) operations for the champion scenarios you've identified for your library; included in your
โ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ๋ํด ์๋ณ๋ ๋ํ ์๋๋ฆฌ์ค์ ๋จ์ผ(์์์ฑ) ์์ ์ ๋ณด์ฌ์ฃผ๊ธฐ ์ํ ์งง์ ์ํ ์ฝ๋๊ฐ
=> sentence distance : 131
โ line 13
โ docstrings, and Quickstart.
โ Docstrings, ๋น ๋ฅธ ์์์ ํฌํจ๋ฉ๋๋ค.
=> sentence distance : 14
โ line 14
โ `Quickstart`
โ `๋น ๋ฅธ ์์`
=> sentence distance : 10
โ line 14
โ Article on docs.microsoft.com that is similar to but expands on the README content; typically written by your service's content developer.
โ README์ ๋ด์ฉ๊ณผ ์ ์ฌํ์ง๋ง ํ์ฅ๋ ๋ด์ฉ์ docs.microsoft.com์์์ ํญ๋ชฉ. ์ผ๋ฐ์ ์ผ๋ก ์๋น์ค ์ฝํ ์ธ ๊ฐ๋ฐ์๊ฐ ์์ฑํฉ๋๋ค.
=> sentence distance : 118
โ line 15
โ `Conceptual`
โ `๊ฐ๋ `
=> sentence distance : 10
โ line 15
โ Long-form documentation like Quickstarts, Tutorials, How-to guides, and other content on docs.microsoft.com; typically written by your service's content developer.
โ ๋น ๋ฅธ ์์, ์์ต์, ์ฌ์ฉ๋ฒ ๊ฐ์ด๋ ๋ฐ docs.microsoft.com์ ๊ธฐํ ์ฝํ ์ธ ๊ฐ์ ์ฅ๋ฌธ์ ์ค๋ช ์; ์ผ๋ฐ์ ์ผ๋ก ์๋น์ค ์ฝํ ์ธ ๊ฐ๋ฐ์๊ฐ ์์ฑํฉ๋๋ค.
=> sentence distance : 131
โ line 17
โ include your service's content developer in the Architecture Board review for your library. To find the content developer you should work with, check with your team's Program Manager.
โ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ์ํคํ ์ฒ ๋ณด๋ ๋ฆฌ๋ทฐ์ ์๋น์ค ์ฝํ ์ธ ๊ฐ๋ฐ์๋ฅผ ํฌํจ์ํต๋๋ค. ํจ๊ป ์์ ํด์ผ ํ ์ฝํ ์ธ ๊ฐ๋ฐ์๋ฅผ ์ฐพ์ผ๋ ค๋ฉด ํด๋น ํ์ ํ๋ก๊ทธ๋จ ๊ด๋ฆฌ์์๊ฒ ๋ฌธ์ํ์ญ์์ค.
=> sentence distance : 163
โ line 19
โ Contributors Guide].
โ ๊ธฐ์ฌ์ ๊ฐ์ด๋]๋ฅผ ๋ฐ๋ฆ ๋๋ค.
=> sentence distance : 18
โ line 19
โ INTERNAL)
โ ๋ด๋ถ)
=> sentence distance : 8
โ line 19
โ follow the
โ None
=> sentence distance : None
โ line 21
โ adhere to the specifications set forth in the
โ ๊ณต์ฉ ๋ฌธ์๋ฅผ ์์ฑํ ๋
=> sentence distance : 42
โ line 21
โ style guides when you write public-facing documentation. This applies to both long-form documentation like a
โ ์คํ์ผ ๊ฐ์ด๋์ ๋ช ์๋ ์ฌํญ๋ค์ ์ค์ํฉ๋๋ค. ์ด ๋ถ๋ถ์
=> sentence distance : 101
โ line 21
โ and the docstrings in your code.
โ ๊ฐ์ ๊ธด ํ์์ ๋ฌธ์์ ์ฝ๋ ๋ด์ Docstrings ๋ชจ๋์ ์ ์ฉ๋ฉ๋๋ค.
=> sentence distance : 30
โ line 21
โ INTERNAL)
โ ๋ด๋ถ)
=> sentence distance : 8
โ line 23
โ Writing Style Guide].
โ ์์ฑ ์คํ์ผ ๊ฐ์ด๋].
=> sentence distance : 17
โ line 24
โ Cloud Style Guide].
โ ํด๋ผ์ฐ๋ ์คํ์ผ ๊ฐ์ด๋].
=> sentence distance : 15
โ line 26
โ requirement/MUST id="general-docs-content-governance"
โ requirement/SHOULD id="general-docs-to-silence"
=> sentence distance : 17
โ line 26
โ use the [Acrolinx VS Code extension] when authoring or editing public-facing Markdown files, such as library READMEs, migration guides, and troubleshooting guides. Changelogs are an exception to this rule. Acrolinx is licensed for use only in the public and private GitHub repos for Tier 1 language SDKs. (MICROSOFT INTERNAL)
โ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ๋ช ๋ฃํ๊ฒ ๋ฌธ์ํํฉ๋๋ค. Docstrings์์ API๋ฅผ ๋ช ํํ๊ฒ ์ค๋ช ํจ์ผ๋ก์จ ๊นํ๋ธ ์ด์๋ฅผ ์ต์ํํ๊ณ ์ฌ์ฉ ๊ณผ์ ์ ๋ฐ๋ฅธ ๊ฐ๋ฐ์๋ค์ ์ง๋ฌธ๊ฑฐ๋ฆฌ๋ค์ ์ฌ์ ์ ์ฐจ๋จํฉ๋๋ค. ์๋น์ค ์ ํ ๋ฐ ๋ฐ์ํ ์ ์๋ ์ค๋ฅ์ ์ค๋ฅ๋ฅผ ๋ฐฉ์งํ๊ณ ๋ณต๊ตฌํ๋ ๋ฐฉ๋ฒ์ ๋ํ ์ ๋ณด๋ฅผ ํฌํจํฉ๋๋ค.
=> sentence distance : 286
โ line 28
โ {% include requirement/SHOULD id="general-docs-to-silence" %} attempt to document your library into silence. Preempt developers' usage questions and minimize GitHub issues by clearly explaining your API in the docstrings. Include information on service limits and errors they might hit, and how to avoid and recover from those errors.
โ ์ฝ๋๋ฅผ ์์ฑํ ๋, *doc it so you never hear about it again.* ๋ต๋ณํด์ผ ํ๋ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ๊ดํ ์ง๋ฌธ์ด ์ ์์๋ก, ์๋น์ค์ ์ถ๊ฐ๋ ์๋ก์ด ๊ธฐ๋ฅ์ ๊ฐ๋ฐํ๋๋ฐ ๋ ๋ง์ ์๊ฐ์ ์ธ ์ ์์ต๋๋ค.
=> sentence distance : 282
โ line 30
โ As you write your code, *doc it so you never hear about it again.* The less questions you have to answer about your client library, the more time you have to build new features for your service.
โ ### ์ฝ๋ ์กฐ๊ฐ
=> sentence distance : 192
โ line 32
โ ### Code snippets
โ {% include requirement/MUST id="general-docs-include-snippets" %} ์ ์ฅ์ ๋ด์ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์ฝ๋์ ํจ๊ป ์์ ์ฝ๋ ์กฐ๊ฐ๋ค์ ํฌํจํ์ญ์์ค. ์ฝ๋ ์กฐ๊ฐ๋ค์ ๋๋ถ๋ถ์ ๊ฐ๋ฐ์๊ฐ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ก ์ํํด์ผ ํ๋ ์์ ๋ค์ ๋ช ํํ๊ณ ๊ฐ๊ฒฐํ๊ฒ ์ค๋ช ํด์ผ ํฉ๋๋ค. ์ฝ๋ ์กฐ๊ฐ๋ค์ ๋ชจ๋ ๊ณตํต ์์ , ํนํ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ์ฒ์ ์ฌ์ฉํ๋ ์ด์ฉ์์๊ฒ ๋ณต์กํ๊ฑฐ๋ ์ด๋ ค์ธ ์ ์๋ ์์ ๋ค์ ํฌํจํด์ผ ํฉ๋๋ค. ์ต์ํ, ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ๋ํด ์๋ณํ ๋ํ ์๋๋ฆฌ์ค์ ๋ํ ์ฝ๋ ์กฐ๊ฐ์ ํฌํจํฉ๋๋ค.
=> sentence distance : 268
โ line 34
โ id="general-docs-include-snippets"
โ id="general-docs-build-snippets"
=> sentence distance : 5
โ line 34
โ include example code snippets alongside your library's code within the repository. The snippets should clearly and succinctly demonstrate the operations most developers need to perform with your library. Include snippets for every common operation, and especially for those that are complex or might otherwise be difficult for new users of your library. At a bare minimum, include snippets for the champion scenarios you've identified for the library.
โ ์ ์ฅ์์ ์ฐ์ ํตํฉ(CI)์ ์ด์ฉํด ์ฝ๋ ์กฐ๊ฐ๋ค์ ๋น๋ํ๊ณ ํ ์คํธํ์ฌ ๊ธฐ๋ฅ์ด ์ ์ง๋๊ณ ์๋์ง ํ์ธํฉ๋๋ค.
=> sentence distance : 438
โ line 36
โ id="general-docs-build-snippets"
โ id="general-docs-snippets-in-docstrings"
=> sentence distance : 17
โ line 36
โ build and test your example code snippets using the repository's continuous integration (CI) to ensure they remain functional.
โ ์์ ์ฝ๋ ์กฐ๊ฐ๋ค์ ๋ผ์ด๋ธ๋ฌ๋ฆฌ Docstrings์ ํฌํจ์์ผ API ์ฐธ์กฐ์ ํ์ํฉ๋๋ค. ์ธ์ด๋ ํด๋น ๋๊ตฌ๊ฐ ์ด๋ฅผ ์ง์ํ๋ ๊ฒฝ์ฐ, ์ด ์ฝ๋ ์กฐ๊ฐ๋ค์ Docstrings์์ API ์ฐธ์กฐ๋ก ์ง์ ์์งํฉ๋๋ค. ์๋ฅผ ๋ค์ด, Python Docstrings์ 'literalinclude' ์ง์์ด๋ฅผ ์ฌ์ฉํ์ฌ Sphinx๊ฐ [์ฝ๋ ์กฐ๊ฐ์ ์๋์ผ๋ก ์์ง][1]ํ๋๋ก ์ง์ํฉ๋๋ค.
=> sentence distance : 171
โ line 38
โ requirement/MUST id="general-docs-snippets-in-docstrings"
โ requirement/MUSTNOT id="general-docs-operation-combinations"
=> sentence distance : 20
โ line 38
โ include the example code snippets in your library's docstrings so they appear in its API reference. If the language and its tools support it, ingest these snippets directly into the API reference from within the docstrings. For example, use the `literalinclude` directive in Python docstrings to instruct Sphinx to [ingest the snippets automatically][1].
โ ํ์์ด๋ ๋ฉค๋ฒ๋ฅผ ๋ณด์ฌ์ฃผ๋๋ฐ ํ์ํ์ง ์๊ฑฐ๋ ์์์ฑ ์์ ์ ๋ณด์ฌ์ฃผ๋ ๊ธฐ์กด ์ฝ๋ ์กฐ๊ฐ์ *์ถ๊ฐ*๋์ง ์๋ ํ ์ฝ๋ ์กฐ๊ฐ์์ ํ๋ ๋ณด๋ค ๋ง์ ์์ ์ ๊ฒฐํฉํฉ๋๋ค. ์๋ฅผ ๋ค์ด, ํ๋์ Cosmos DB ์ฝ๋ ์กฐ๊ฐ์๋ ๊ณ์ ๊ณผ ์ปจํ ์ด๋๋ฅผ ์์ฑํ๋ ์์ ์ด ๋์ ํฌํจ๋์ด์๋ ์ ๋ฉ๋๋ค--์ฝ๋ ์กฐ๊ฐ์ ๊ณ์ ์์ฑ์ฉ์ผ๋ก ํ๋, ์ปจํ ์ด๋ ์์ฑ์ฉ์ผ๋ก ํ๋ ์ด ๋ ๊ฐ๋ฅผ ๋ง๋ค์ด์ผ ํฉ๋๋ค.
=> sentence distance : 305
โ line 40
โ {% include requirement/MUSTNOT id="general-docs-operation-combinations" %} combine more than one operation in a code snippet unless it's required for demonstrating the type or member, or it's *in addition to* existing snippets that demonstrate atomic operations. For example, a Cosmos DB code snippet should not include both account and container creation operations--create two different snippets, one for account creation, and one for container creation.
โ ๊ฒฐํฉ๋ ์์ ๋ค์ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์๋น์์๊ฒ ํ์ฌ ์ด์ ์์ ๋ฒ์ด๋ ์ ์๋ ์ถ๊ฐ ์์ ์ ๋ํ ์ง์์ ์๊ตฌํ์ฌ ๋ถํ์ํ ๋ง์ฐฐ์ ์ผ๊ธฐํฉ๋๋ค. ๊ฒฐํฉ๋ ์์ ๋ค์ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์๋น์๋ค์ด ๋จผ์ ์์ ์ค์ธ ์์ ์ ์ฃผ๋ณ ์ ์ ์ฝ๋๋ฅผ ํ์ ํ ๋ค์, ๋ค์ ์์ ์ ํ์ํ ์ฝ๋๋ง ์ ์คํ๊ฒ ์ถ์ถํ ๊ฒ์ ์๊ตฌํฉ๋๋ค. ๋ฐ๋ผ์ ๊ฐ๋ฐ์๋ ๋๋ ์ฝ๋ ์กฐ๊ฐ์ ๋ณต์ฌํ์ฌ ํ๋ก์ ํธ์ ๋ถ์ฌ๋ฃ๊ธฐ ํ ์ ์์ต๋๋ค.
=> sentence distance : 407
537 words added. 416 words deleted.
Added words rate 110.04098360655739% (537 / 488 words)
Deleted words rate 85.24590163934425% (416 / 488 words)
-
implementation.md : File Modified +82 / -62 ๐ 3563
โ line 60
โ send
โ several-] methods that [-perform
=> sentence distance : 29
โ line 60
โ to
โ on
=> sentence distance : 2
โ line 60
โ sent
โ directly passed
=> sentence distance : 13
โ line 60
โ the service as URL segments, query parameters, request header values, and request bodies (typically JSON or XML).
โ an Azure service.
=> sentence distance : 100
โ line 60
โ service; examples
โ not passed directly to the service, but-] used {+solely+} within the client library {+and are not sent+} to[-fulfill-] the [-request. Examples of client parameters include values that
=> sentence distance : 168
โ line 60
โ path parameters, CancellationTokens
โ used to construct a URI,
=> sentence distance : 30
โ line 60
โ paths. If, for example, a path parameter is not validated, it could result in sending a request
โ a-] file [-that needs
=> sentence distance : 80
โ line 60
โ a malformed URI, which could prevent the service from having the opportunity
โ be uploaded
=> sentence distance : 69
โ line 60
โ do validation on it.
โ storage.
=> sentence distance : 17
โ line 60
โ These methods take two kinds of parameters: _service parameters_ and _client parameters_.
โ None
=> sentence distance : None
โ line 60
โ solely
โ None
=> sentence distance : None
โ line 60
โ and are not sent
โ None
=> sentence distance : None
โ line 60
โ None
โ several
=> sentence distance : None
โ line 60
โ None
โ not passed directly to the service, but
=> sentence distance : None
โ line 60
โ None
โ fulfill
=> sentence distance : None
โ line 60
โ None
โ a
=> sentence distance : None
โ line 180
โ (`traceparent` and `tracestate` per [W3C Trace-Context](https://www.w3.org/TR/trace-context/) standard))
โ (`traceparent`, `tracestate`, etc.)
=> sentence distance : 72
82 words added. 62 words deleted.
Added words rate 2.301431378052203% (82 / 3563 words)
Deleted words rate 1.7401066516980073% (62 / 3563 words)
-
introduction.md : File Modified +509 / -386 ๐ 442
โ line 2
โ "General Guidelines: Introduction"
โ "๊ณตํต ๊ฐ์ด๋๋ผ์ธ: ์๊ฐ"
=> sentence distance : 29
โ line 9
โ The general guidelines are for the benefit of:
โ ๋ณธ ๊ณตํต ๊ฐ์ด๋๋ผ์ธ ๋ฌธ์๋ ๋ค์๊ณผ ๊ฐ์ ๋ถ๋ค์๊ฒ ์ ์ฉํฉ๋๋ค:
=> sentence distance : 39
โ line 11
โ Language-specific guidelines authors.
โ ์ธ์ด๋ณ ๊ฐ์ด๋๋ผ์ธ ์์ฑ์
=> sentence distance : 35
โ line 12
โ Client library designers for languages that have no specific language guidelines.
โ ํน์ ์ธ์ด ๊ฐ์ด๋๋ผ์ธ์ด ์์ง ์์ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ๋์์ด๋
=> sentence distance : 74
โ line 14
โ If you are working in a language with no specific language guidelines, please work with the
โ ํน์ ์ธ์ด ๊ฐ์ด๋๋ผ์ธ์ด ์๋ ์ธ์ด๋ก ์์ ํ๋ ๊ฒฝ์ฐ,
=> sentence distance : 84
โ line 14
โ Board] more closely to ensure the client library is appropriately designed and the developer experience is exemplary.
โ Board]์ ๋์ฑ ๊ธด๋ฐํ๊ฒ ํ๋ ฅํ์ฌ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๊ฐ ์ ์ ํ๊ฒ ์ค๊ณ๋๊ณ ๊ฐ๋ฐ์ ๊ฒฝํ์ด ๋ชจ๋ฒ์ ์ธ์ง ํ์ธํ์ธ์.
=> sentence distance : 100
โ line 16
โ Design principles
โ ๋์์ธ ์์น
=> sentence distance : 16
โ line 18
โ SDK should be designed to enhance the productivity of developers connecting to
โ SDK๋
=> sentence distance : 75
โ line 18
โ services. Other qualities (such as completeness, extensibility, and performance) are important but secondary. Productivity is achieved by adhering to the principles described below:
โ ์๋น์ค์ ์ฐ๊ฒฐํ๋ ๊ฐ๋ฐ์์ ์์ฐ์ฑ์ ์ฆ๋์์ผ์ผ ํฉ๋๋ค. ์์ฑ๋, ํ์ฅ์ฑ, ์ฑ๋ฅ๊ณผ ๊ฐ์ ๋ถ๋ถ๋ค๋ ์ค์ํ์ง๋ง ๋ถ์์ ์ธ ๊ฒ์ด๋ฉฐ, ์์ฐ์ฑ์ ๋ค์๊ณผ ๊ฐ์ ์์น๋ค์ ์ ์ฉํจ์ผ๋ก์ ์ด๋ฃฐ ์ ์์ต๋๋ค:
=> sentence distance : 161
โ line 20
โ Idiomatic
โ ๊ด์ต์ ์ผ๋ก (Idiomatic)
=> sentence distance : 8
โ line 22
โ The SDK should follow the general design guidelines and conventions for the target language. It should feel natural to a developer in the target language.
โ SDK๋ ํด๋น ์ธ์ด์ ๊ท์น๊ณผ ์ผ๋ฐ์ ์ธ ๋์์ธ ๊ฐ์ด๋๋ผ์ธ์ ๋ฐ๋ผ์ผ ํฉ๋๋ค. ํด๋น ์ธ์ด์ ๊ฐ๋ฐ์๊ฐ ์์ฐ์ค๋ฝ๊ฒ ๋ฐ์๋ค์ผ ์ ์๊ฒ ํด์ผ ํฉ๋๋ค.
=> sentence distance : 132
โ line 23
โ We embrace the ecosystem with its strengths and its flaws.
โ ์ฐ๋ฆฌ๋ ๊ทธ ์ํ๊ณ์ ์ฅ๋จ์ ์ ๊ฐ์ํด์ผ ํฉ๋๋ค.
=> sentence distance : 52
โ line 24
โ We work with the ecosystem to improve it for all developers.
โ ์ฐ๋ฆฌ๋ ๋ชจ๋ ๊ฐ๋ฐ์๋ฅผ ์ํด ์ํ๊ณ์ ํ๋ ฅํด ๊ฐ์ ํฉ๋๋ค.
=> sentence distance : 53
โ line 26
โ Consistent
โ ์ผ๊ด์ฑ์๊ฒ (Consistent)
=> sentence distance : 8
โ line 28
โ Client libraries should be consistent within the language, consistent with the service and consistent between all target languages. In cases of conflict, consistency within the language is the highest priority and consistency between all target languages is the lowest priority.
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ ์ธ์ด์, ๋ค๋ฅธ ์ธ์ด์, ์๋น์ค ๋ชจ๋์ ๋ํด ์ผ๊ด์ ์ด์ด์ผ ํฉ๋๋ค. ์ถฉ๋์ด ์ผ์ด๋ ๊ฒ์ ์๊ฐํด ์ธ์ด์ ์ผ๊ด์ฑ์ ๊ฐ์ฅ ๋์ ์ฐ์ ์์๋ฅผ ๊ฐ์ ธ์ผ ํ๋ฉฐ, ๋ค๋ฅธ ์ธ์ด์์ ์ผ๊ด์ฑ์ ๋น๊ต์ ๊ฐ์ฅ ๋ฎ์ ์ฐ์ ์์๋ฅผ ๊ฐ์ง๋๋ค.
=> sentence distance : 247
โ line 29
โ Service-agnostic concepts such as logging,
โ ๋ก๊น ,
=> sentence distance : 41
โ line 29
โ communication, and error handling should be consistent. The developer should not have to relearn service-agnostic concepts as they move between client libraries.
โ ํต์ , ์๋ฌ ํธ๋ค๋ง๊ณผ ๊ฐ์ ์๋น์ค์ ๊ด๋ จ์๋ ๊ฐ๋ ๋ค๋ ์ผ๊ด์ ์ด์ด์ผ ํฉ๋๋ค. ๊ฐ๋ฐ์๊ฐ ๋ค๋ฅธ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ๊ฐ ์ด๋ํ ๋ ์ด๋ฌํ ๊ฐ๋ ๋ค์ ๋ค์ ํ์ตํ ํ์๊ฐ ์๊ฒ ํด์ผ ํฉ๋๋ค.
=> sentence distance : 140
โ line 30
โ Consistency of terminology between the client library and the service is a good thing that aids in diagnosability.
โ ํด๋ผ๋ฆฌ์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ๊ทธ ์๋น์ค ๊ฐ ์ฉ์ด์ ์ผ๊ด์ฑ์ ์ง๋จํ๋ ๋ฐ ๋์์ ์ฃผ๋ ์ข์ ๊ฒ์ ๋๋ค.
=> sentence distance : 101
โ line 31
โ All differences between the service and client library must have a good (articulated) reason for existing, rooted in idiomatic usage rather than whim.
โ ์๋น์ค์ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ๊ฐ ๋ชจ๋ ์ฐจ์ด์ ๋ค์ ์ผ์์ ์ธ ์ด์ ๊ฐ ์๋๋ผ ๊ธฐ์กด์ ๊ด์ต์ ์ธ ์ฌ์ฉ์ ๊ธฐ๋ฐ์ผ๋ก ํฉ๋นํ ์ด์ ๊ฐ ์์ด์ผํ ๊ฒ์ ๋๋ค.
=> sentence distance : 133
โ line 32
โ The
โ ๊ฐ๊ฐ ์ธ์ด์
=> sentence distance : 6
โ line 32
โ SDK for each target language feels like a single product developed by a single team.
โ SDK์ ํ ํ์์ ํ๋์ ์ ํ์ด ๋์ค๋ ๊ฒ์ฒ๋ผ ๋๊ปด์ ธ์ผ ํฉ๋๋ค.
=> sentence distance : 72
โ line 33
โ There should be feature parity across target languages. This is more important than feature parity with the service.
โ ํด๋น ์ธ์ด ๊ฐ ๋์ผํ ๊ธฐ๋ฅ์ด ์์ด์ผ ํฉ๋๋ค. ์๋น์ค์ ๋์ผํ ๊ธฐ๋ฅ๋ณด๋ค ๋ ์ค์ํ ๋ถ๋ถ์ ๋๋ค.
=> sentence distance : 102
โ line 35
โ Approachable
โ ์ ๊ทผํ๊ธฐ์ฝ๊ฒ (Approachable)
=> sentence distance : 9
โ line 37
โ We are experts in the supported technologies so our customers, the developers, don't have to be.
โ ์ฐ๋ฆฌ๋ ์ง์ํ๋ ๊ธฐ์ ์ ์ ๋ฌธ๊ฐ์ ๋๋ค. ๊ทธ๋์ ์ฐ๋ฆฌ์ ๊ณ ๊ฐ์ธ ๊ฐ๋ฐ์๊น์ง ์ ๋ฌธ์ ์ธ ์ง์์ ํ์๋ก ํ์ง๋ ์์๋ ๋ ๊ฒ์ ๋๋ค.
=> sentence distance : 84
โ line 38
โ Developers should find great documentation (hero tutorial, how to articles, samples, and
โ ๊ฐ๋ฐ์๋ค์ด ํํ ๋ฆฌ์ผ, ์์ , ์ํฐํด,
=> sentence distance : 82
โ line 38
โ documentation) that makes it easy to be successful with the
โ ๋ฌธ์ ๋ฑ ์์ง์ ๋ฌธ์๋ฅผ ์ฐพ์๋ณผ ์ ์๊ฒ ํด์ผํฉ๋๋ค. ๊ทธ๋์
=> sentence distance : 52
โ line 38
โ service.
โ ์๋น์ค๋ฅผ ์ฝ๊ฒ ์ฑ๊ณตํ ์ ์์ด์ผ ํฉ๋๋ค.
=> sentence distance : 21
โ line 39
โ Getting off the ground should be easy through the use of predictable defaults that implement best practices. Think about progressive concept disclosure.
โ ๋ฒ ์คํธ ํ๋ํฐ์ค๋ฅผ ์ ์ฉํ ์ ์๋ ์์ธก ๊ฐ๋ฅํ ๊ธฐ๋ณธ๊ฐ๋ค์ ์ฌ์ฉํด ์ฝ๊ฒ ์์ํ ์ ์์ด์ผ ํฉ๋๋ค. ์ ์ง์ ์ผ๋ก ๊ฐ๋ ์ ์๊ฐํ ์ ์๊ฒ ์๊ฐํด๋ณด์ธ์.
=> sentence distance : 132
โ line 40
โ The SDK should be easily acquired through the most normal mechanisms in the target language and ecosystem.
โ SDK๋ ํด๋น ์ธ์ด์ ์ํ๊ณ์ ๊ฐ์ฅ ์ผ๋ฐ์ ์ธ ๋งค์ปค๋์ฆ์ ํตํด ์ฝ๊ฒ ์ป์ ์ ์์ด์ผ ํฉ๋๋ค.
=> sentence distance : 90
โ line 41
โ Developers can be overwhelmed when learning new service concepts. The core use cases should be discoverable.
โ ๊ฐ๋ฐ์๋ค์ด ์๋ก์ด ์๋น์ค ๊ฐ๋ ์ ๋ฐฐ์ฐ๋ ๋ฐ ์ฌ๋ก์กํ ์ ์๊ฒ ํด์ผ ํฉ๋๋ค. ํต์ฌ ์ฌ์ฉ ์ฌ๋ก๋ฅผ ๋ฐ๊ฒฌํ ์ ์์ด์ผ ํฉ๋๋ค.
=> sentence distance : 93
โ line 43
โ Diagnosable
โ ๋ถ์๊ฐ๋ฅํ๊ฒ (Diagnosable)
=> sentence distance : 9
โ line 45
โ The developer should be able to understand what is going on.
โ ๊ฐ๋ฐ์๊ฐ ์ด๋ป๊ฒ ๋์๊ฐ๋์ง ์ฝ๊ฒ ์ดํดํ ์ ์๊ฒ ํด์ผํฉ๋๋ค.
=> sentence distance : 52
โ line 46
โ It should be discoverable when and under what circumstances a network call is made.
โ ์ด๋ ์ํฉ์์ ๋คํธ์ํฌ ํธ์ถ์ด ์ด๋ฃจ์ด์ง๋์ง ์ธ์งํ ์ ์์ด์ผ ํฉ๋๋ค.
=> sentence distance : 74
โ line 47
โ Defaults are discoverable and their intent is clear.
โ ๊ธฐ๋ณธ๊ฐ๋ค์ ์ ์ ์์ด์ผ ํ๋ฉฐ ๊ทธ ์๋ ๋ํ ๋ช ํํด์ผ ํฉ๋๋ค.
=> sentence distance : 45
โ line 48
โ Logging, tracing, and exception handling are fundamental and should be thoughtful.
โ ๋ ธ๊น , ์ถ์ , ์์ธ์ฒ๋ฆฌ๋ ๊ธฐ๋ณธ์ ์ด๋ฉฐ, ์ ์คํด์ผ ํฉ๋๋ค.
=> sentence distance : 74
โ line 49
โ Error messages should be concise, correlated with the service, actionable, and human readable. Ideally, the error message should lead the consumer to a useful action that they can take.
โ ์๋ฌ ๋ฉ์์ง๋ ๊ฐ๊ฒฐํ๊ณ , ์๋น์ค๊ณผ ์ฐ๊ด์์ด์ผ ํ๊ณ , ์ด์ฉํ ์ ์์ด์ผ ํ๋ฉฐ ์ฌ๋์ด ์ฝ์ ์ ์๊ฒ ํด์ผํฉ๋๋ค.
=> sentence distance : 168
โ line 50
โ Integrating with the preferred debugger for the target language should be easy.
โ ํด๋น ์ธ์ด์ ์ ํธ๋๋ ๋๋ฒ๊ฑฐ๋ค๊ณผ์ ํตํฉ์ด ์ฌ์์ผ ํฉ๋๋ค.
=> sentence distance : 72
โ line 52
โ Dependable
โ ๋ฏฟ์์งํ๊ฒ (Dependable)
=> sentence distance : 8
โ line 54
โ Breaking changes are more harmful to a user's experience than most new features and improvements are beneficial.
โ ๊ฐ์์ค๋ฌ์ด ๋ณํ๋ ๋๋ถ๋ถ์ ์๋ก์ด ๊ธฐ๋ฅ๋ณด๋ค ์ฌ์ฉ์ ๊ฒฝํ์ ์ข์ง ์์ผ๋ฉฐ ๊ฐ์ ์ฌํญ์ด ์ ์ตํฉ๋๋ค.
=> sentence distance : 101
โ line 55
โ Incompatibilities should never be introduced deliberately without thorough review and very strong justification.
โ ๋งค์ฐ ํฉ๋นํ ์ด์ ์ ๋ฆฌ๋ทฐ ์์ด ํธํ์ฑ์ ๊นจ๋ฒ๋ ค์๋ ์๋ฉ๋๋ค. ์๋์ ์ผ๋ก๋ผ๋ ์ด๋ฅผ ๋ง์์ผ ํฉ๋๋ค.
=> sentence distance : 100
โ line 56
โ Do not rely on dependencies that can force our hand on compatibility.
โ ํธํ์ฑ์ ์ํฅ์ ์ค ์ ์๋ ๋ํ๋์์ ์์กดํด์๋ ์๋ฉ๋๋ค.
=> sentence distance : 61
509 words added. 386 words deleted.
Added words rate 115.15837104072398% (509 / 442 words)
Deleted words rate 87.33031674208145% (386 / 442 words)
-
terminology.md : File Modified +496 / -345 ๐ 416
โ line 2
โ "General Guidelines: Terminology"
โ "๊ณตํต ๊ฐ์ด๋๋ผ์ธ: ์ฉ์ด"
=> sentence distance : 28
โ line 9
โ Throughout the guidelines, the following terms should be understood:
โ ๊ฐ์ด๋๋ผ์ธ์ ํตํด ๋ค์์ ์ฉ์ด๋ค์ ์ดํดํ ์ ์์ต๋๋ค:
=> sentence distance : 61
โ line 11
โ Architecture Board
โ ์ํคํ ์ฒ ๋ณด๋
=> sentence distance : 17
โ line 12
โ Board] is comprised of language experts who advise and review client libraries used for accessing Azure services.
โ Board]๋ ์ ์ ์๋น์ค๋ฅผ ์ก์ธ์คํ๋ ๋ฐ ์ฌ์ฉ๋๋ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ์กฐ์ธํ๊ณ ๋ฆฌ๋ทฐํ๋ ์ธ์ด ์ ๋ฌธ๊ฐ๋ก ์ด๋ฃจ์ด์ ธ ์์ต๋๋ค.
=> sentence distance : 93
โ line 12
โ The
โ None
=> sentence distance : None
โ line 14
โ Azure
โ ์ ์
=> sentence distance : 5
โ line 15
โ The collection of
โ ์ ์ ์๋น์ค์ ์ก์ธ์คํ ๋ ์ฌ์ฉ๋๋ ๋จ์ผ ๋์ ์ธ์ด์ ๋ํ
=> sentence distance : 30
โ line 15
โ for a single target language, used for accessing Azure services.
โ ๋ชจ์์ ๋๋ค.
=> sentence distance : 63
โ line 17
โ Azure Core
โ ์ ์ ์ฝ์ด
=> sentence distance : 9
โ line 18
โ A dependency of many client libraries. The Azure Core library provides access to the HTTP pipeline, common credential types, and other types that are appropriate to the Azure SDK as a whole.
โ ๋ง์ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ์ข ์์ฑ์ ๋๋ค. ์ ์ ์ฝ์ด ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ ์ ์ SDK์ ์ ์ฒด์ ์ผ๋ก ์ ํฉํ ํ์ดํ๋ผ์ธ, ์ผ๋ฐ์ ์ธ ์๊ฒฉ ์ฆ๋ช ํ์, ๊ทธ๋ฆฌ๊ณ ๋ค๋ฅธ ์ ํ์ ๋ํ ์ก์ธ์ค๋ฅผ ์ ๊ณตํฉ๋๋ค.
=> sentence distance : 167
โ line 20
โ Client Library
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ
=> sentence distance : 13
โ line 21
โ A library (and associated tools, documentation, and samples) that _consumers_ use to ease working with an Azure service. There is generally a client library per Azure service and per target language. Sometimes a single client library will contain the ability to connect to multiple services.
โ ์ ์ ์๋น์ค ์์ ์ ์ฝ๊ฒํ๊ธฐ ์ํด _consumers_๊ฐ ์ฌ์ฉํ๋ ๋ผ์ด๋ธ๋ฌ๋ฆฌ(๋ฐ ๊ด๋ จ ๋๊ตฌ, ๋ฌธ์, ์ํ). ์ผ๋ฐ์ ์ผ๋ก ์ ์ ์๋น์ค ๊ทธ๋ฆฌ๊ณ ๋์ ์ธ์ด ๋น ํ๋์ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๊ฐ ์์ต๋๋ค. ๊ฐ๋ ๋จ์ผ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ ๋ค์์ ์๋น์ค๋ฅผ ์ฐ๊ฒฐํ ์ ์๋ ๊ธฐ๋ฅ์ ํฌํจํฉ๋๋ค.
=> sentence distance : 247
โ line 23
โ Consumer
โ ์๋น์
=> sentence distance : 8
โ line 24
โ Where appropriate to disambiguate between the various types of developers, we use the term _consumer_ to indicate the developer who is using a client library in an app to connect to an Azure service.
โ ๋ค์ํ ์ ํ์ ๊ฐ๋ฐ์๋ค์ ๊ตฌ๋ถํ๊ธฐ ์ํด ์ฐ๋ฆฌ๋ ์ฑ์์ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ์ฌ์ฉํ์ฌ ์ ์ ์๋น์ค์ ์ฐ๊ฒฐํ๋ ๊ฐ๋ฐ์๋ฅผ ํ์ํ๊ธฐ ์ํด _consumer_๋ผ๋ ์ฉ์ด๋ฅผ ์ฌ์ฉํฉ๋๋ค.
=> sentence distance : 176
โ line 27
โ The comments embedded within the code that describe the
โ ๊ตฌํ์ค์ธ
=> sentence distance : 55
โ line 27
โ surface being implemented. The _docstrings_ are extracted and post-processed during the build to generate
โ ํ๋ฉด์ ์ค๋ช ํ๋ ์ฝ๋์ ํฌํจ๋ ์ฃผ์์ ๋๋ค. ๋น๋ ์ค์ _docstrings_๋ฅผ ์ถ์ถํ๊ณ ์ฌ์ ์ฒ๋ฆฌํ์ฌ
=> sentence distance : 88
โ line 27
โ reference documentation.
โ ์ฐธ์กฐ ๋ฌธ์๋ฅผ ์์ฑํฉ๋๋ค.
=> sentence distance : 22
โ line 29
โ Library Developer
โ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ๊ฐ๋ฐ์
=> sentence distance : 16
โ line 30
โ Where appropriate to disambiguate between the various types of developers, we use the term
โ ๋ค์ํ ์ ํ์ ๊ฐ๋ฐ์๋ค์ ๊ตฌ๋ถํ๊ธฐ ์ํด ์ฐ๋ฆฌ๋ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ์์ฑํ๋ ๊ฐ๋ฐ์๋ฅผ ํ์ํ๊ธฐ ์ํด
=> sentence distance : 81
โ line 30
โ developer_ to indicate the developer who is writing a client library.
โ developer_๋ผ๋ ์ฉ์ด๋ฅผ ์ฌ์ฉํฉ๋๋ค.
=> sentence distance : 56
โ line 32
โ Package
โ ํจํค์ง
=> sentence distance : 7
โ line 33
โ A client library after it has been packaged for distribution to consumers. Packages are generally installed using a package manager from a package repository.
โ ์๋น์๋ค์๊ฒ ๋ฐฐํฌํ ์ ์๋๋ก ํจํค์ง๋ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ๋๋ค. ํจํค์ง๋ ์ผ๋ฐ์ ์ผ๋ก ํจํค์ง ๋ฆฌํฌ์งํ ๋ฆฌ์ ํจํค์ง ๊ด๋ฆฌ์๋ฅผ ์ฌ์ฉํ์ฌ ์ค์น๋ฉ๋๋ค.
=> sentence distance : 143
โ line 35
โ Package Repository
โ ํจํค์ง ๋ฆฌํฌ์งํ ๋ฆฌ
=> sentence distance : 17
โ line 36
โ Each client library is published separately to the appropriate language-specific package repository. For example, we distribute JavaScript libraries to [npmjs.org](https://npmjs.org) (also known as the NPM Registry), and Python libraries to [PyPI](https://pypi.org/). These releases are performed exclusively by the Azure
โ ๊ฐ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ ํด๋น ์ธ์ด๋ณ ํจํค์ง ๋ฆฌํฌ์งํ ๋ฆฌ์ ๋ณ๋๋ก ๊ฒ์๋ฉ๋๋ค. ์๋ฅผ ๋ค์ด, [npmjs.org](https://npmjs.org)์๋ ์๋ฐ์คํฌ๋ฆฝํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ(NPM Registry)๋ฅผ, [PyPI](https://pypi.org/)์์๋ ํ์ด์ฌ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ๋ฐฐํฌํฉ๋๋ค. ์ด๋ฌํ ๋ฆด๋ฆฌ์ค๋ ์ ์
=> sentence distance : 235
โ line 36
โ engineering systems team. Consumers install packages using a package manager. For example, a JavaScript consumer might use
โ ์์ง๋์ด๋ง ํ๋ง์ด ์ํํฉ๋๋ค. ์๋น์๋ ํจํค์ง ๊ด๋ฆฌ์๋ฅผ ํตํ์ฌ ํจํค์ง๋ฅผ ์ค์นํฉ๋๋ค. ์๋ฅผ ๋ค์ด ์๋ฐ์คํฌ๋ฆฝํธ๋
=> sentence distance : 112
โ line 36
โ npm, or similar, whereas a Python consumer will use `pip` to install packages into their project.
โ npm๋ฑ์ ์ฌ์ฉํ ์ ์๊ณ ํ์ด์ฌ ์๋น์๋ `pip`์ ์ฌ์ฉํ์ฌ ํ๋ก์ ํธ์ ํจํค์ง๋ฅผ ์ค์นํ ์ ์์ต๋๋ค.
=> sentence distance : 77
โ line 38
โ Progressive Concept Disclosure
โ ํ๋ก๊ทธ๋ ์๋ธ ์ปจ์ ๊ณต๊ฐ
=> sentence distance : 28
โ line 39
โ The first interaction with the client library should not rely on advanced service concepts. As the consumer of the library becomes more adept, we expose the concepts necessary at the point at which the consumer needs those concepts for implementation.
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์์ ์ฒซ ๋ฒ์งธ ์ํธ ์์ฉ์ ๊ณ ๊ธ ์๋น์ค ์ปจ์ ๋ค์ ์์งํด์๋ ์๋ฉ๋๋ค. ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ์๋น์๊ฐ ๋ ๋ฅ์ํด์ง์ ๋ฐ๋ผ, ์ฐ๋ฆฌ๋ ์๋น์๊ฐ ๊ตฌํ์ ์ํด ๊ทธ๋ฌํ ๊ฐ๋ ์ ํ์๋ก ํ๋ ์์ ์ ํ์ํ ๊ฐ๋ ์ ๊ณต๊ฐํฉ๋๋ค.
=> sentence distance : 222
โ line 39
โ Disclosure] was first discussed by the
โ Disclosure]๋
=> sentence distance : 27
โ line 39
โ Group as an approach to designing better user interfaces.
โ Group์ด ๋ ์ข์ ์ฌ์ฉ์ ์ธํฐํ์ด์ค๋ฅผ ์ค๊ณํ๊ธฐ ์ํ ์ ๊ทผ์ผ๋ก ์ฒ์ ๋ ผ์๋์์ต๋๋ค.
=> sentence distance : 45
โ line 41
โ Requirements
โ ์๊ตฌ์ฌํญ
=> sentence distance : 12
โ line 43
โ Each requirement in this document is labelled and color-coded to show the relative importance. In order from highest importance to lowest importance:
โ ์ด ๋ฌธ์์ ์๊ตฌ์ฌํญ๋ค์ ๋ผ๋ฒจ๋ก ํ์๋์ด ์๊ณ ์๋์ ์ค์์ฑ์ ๋ํ๋ด๊ธฐ ์ํด ์์์ผ๋ก ๊ตฌ๋ถ๋์ด ์์ต๋๋ค. ์ค์๋๊ฐ ๋์ ์์ผ๋ก ์์ฑ๋์์ต๋๋ค:
=> sentence distance : 133
โ line 45
โ adopt this requirement for the client library. If you feel you need an exception, engage with the
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ์๊ตฌ์ฌํญ์ ์ฌ์ฉํด์ฃผ์ธ์. ๋ง์ฝ ์์ธ๊ฐ ํ์ํ๋ค๋ฉด ๊ตฌํ์ ์
=> sentence distance : 90
โ line 45
โ Board] prior to implementation.
โ Board]์ ์์ํด์ฃผ์ธ์.
=> sentence distance : 23
โ line 47
โ adopt this requirement for the client library. If you feel you need an exception, engage with the
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ์๊ตฌ์ฌํญ์ ์ฌ์ฉํ์ง ๋ง์์ฃผ์ธ์. ๋ง์ฝ ์์ธ๊ฐ ํ์ํ๋ค๋ฉด ๊ตฌํ์ ์
=> sentence distance : 89
โ line 47
โ Board] prior to implementation.
โ Board]์ ์์ํด์ฃผ์ธ์.
=> sentence distance : 23
โ line 49
โ strongly consider this requirement for the client library. If not following this advice, you **MUST** disclose the variance during the
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ์๊ตฌ์ฌํญ์ ๊ฐ๋ ฅํ๊ฒ ๊ณ ๋ คํด์ผํฉ๋๋ค. ๋ง์ฝ ์ด ๊ถ์ฅ์ฌํญ์ ๋ฐ๋ฅด์ง ์์ ๊ฒฝ์ฐ, **๋ฐ๋์**
=> sentence distance : 119
โ line 49
โ design review.
โ ๋์์ธ ๋ฆฌ๋ทฐ๋ฅผ ํ ๋ ์ฐจ์ด๋ฅผ ๊ณต๊ฐํด์ผํฉ๋๋ค.
=> sentence distance : 22
โ line 51
โ strongly consider this requirement for the client library. If not following this advice, you **MUST** disclose the variance during the
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ์๊ตฌ์ฌํญ์ ๊ฐ๋ ฅํ๊ฒ ๊ณ ๋ คํ์ง ๋ง์์ผํฉ๋๋ค. ๋ง์ฝ ์ด ๊ถ์ฅ์ฌํญ์ ๋ฐ๋ฅด์ง ์์ ๊ฒฝ์ฐ, **๋ฐ๋์**
=> sentence distance : 118
โ line 51
โ design review.
โ ๋์์ธ ๋ฆฌ๋ทฐ๋ฅผ ํ ๋ ์ฐจ์ด๋ฅผ ๊ณต๊ฐํด์ผํฉ๋๋ค.
=> sentence distance : 22
โ line 53
โ consider this advice if appropriate to your situation. No notification to the architecture board is required.
โ ๋ง์ฝ ์ฌ๋ฌ๋ถ์ ์ํฉ์ ์ ์ ํ ๊ฒฝ์ฐ ์ด ๊ถ์ฅ์ฌํญ์ ๊ณ ๋ คํด์ผํฉ๋๋ค. ์ํคํ ์ฒ ๋ณด๋์ ํต๋ณดํ ํ์๊ฐ ์์ต๋๋ค.
=> sentence distance : 97
496 words added. 345 words deleted.
Added words rate 119.23076923076923% (496 / 416 words)
Deleted words rate 82.9326923076923% (345 / 416 words)
-
-
golang
-
approved_dependencies.md : File Added ๐ 28
28 words added. -
implementation.md : File Added ๐ 958
958 words added. -
introduction.md : File Added ๐ 5834
5834 words added. -
refs.md : File Added ๐ 11
11 words added.
-
-
ios
-
design.md : File Modified +134 / -27 ๐ 7640
โ line 23
โ guidelines](https://swift.org/documentation/).
โ guidelines](https://swift.org/documentation/api-design-guidelines/).
=> sentence distance : 22
โ line 243
โ include a `latest` property from the client's API version enum which returns
โ return
=> sentence distance : 70
โ line 243
โ preview
โ stable
=> sentence distance : 6
โ line 243
โ latest GA API version for stable SDKs.
โ service that is supported by the client from the enum's `latest` property.
=> sentence distance : 58
โ line 243
โ beta SDKs and
โ None
=> sentence distance : None
โ line 368
โ conventions](https://swift.org/documentation/)
โ conventions](https://swift.org/documentation/api-design-guidelines/#naming)
=> sentence distance : 29
โ line 658
โ Conditional requests are normally performed using HTTP headers. The primary usage provides headers that match the ETag to some known value. The ETag is an opaque identifier that represents a single version of a resource. For example, adding the following header will translate to "if the record's version, specified by the ETag, is not the same".
โ > TODO
=> sentence distance : 344
โ line 707
โ objects (structs and classes)
โ structures
=> sentence distance : 21
โ line 707
โ protocol-neutral
โ protocol neutral
=> sentence distance : 1
โ line 709
โ requirement/SHOULD
โ requirement/MUST
=> sentence distance : 5
โ line 734
โ {% include requirement/MUST id="ios-enums" %} use an `enum` for parameters, properties, and return types when values are known.
โ > TODO
=> sentence distance : 125
โ line 767
โ {% include requirement/MUST id="ios-core-types" %} make use of packages in Azure Core to provide behavior consistent across all Azure SDK libraries. This includes, but is not limited to:
โ > TODO
=> sentence distance : 183
โ line 1014
โ stable
โ GA
=> sentence distance : 6
134 words added. 27 words deleted.
Added words rate 1.7539267015706805% (134 / 7640 words)
Deleted words rate 0.35340314136125656% (27 / 7640 words)
-
implementation.md : File Modified +133 / -50 ๐ 1226
โ line 17
โ Service clients are the main starting points for developers calling Azure services with the Azure SDK. Each client library should have at least one client, so itโs easy to discover. The guidelines in this section describe patterns for the design of a service client. Because for iOS only asynchronous service clients are required, the sections below are organized into general service client guidance.
โ > TODO: Add introductory sentence.
=> sentence distance : 374
โ line 21
โ Service methods are the methods on the client that invoke operations on the service.
โ > TODO: Add introductory sentence.
=> sentence distance : 67
โ line 44
โ None
โ > TODO: Add introductory sentence.
=> sentence distance : None
โ line 48
โ ##### Attributes
โ > TODO
=> sentence distance : 15
โ line 50
โ The following guidance applies to Swift [attributes](https://docs.swift.org/swift-book/ReferenceManual/Attributes.html) :
โ ## SDK Feature Implementation
=> sentence distance : 107
โ line 62
โ // unusable -- will issue a compiler error
โ > TODO: Add introductory sentence.
=> sentence distance : 35
โ line 173
โ {% include requirement/MUST id="ios-testing-unit-xctest" %} use
โ > TODO: Document how to write good tests with
=> sentence distance : 47
โ line 173
โ None
โ existing XCTest framework.
=> sentence distance : None
โ line 174
โ built-in `XCTest` framework for unit testing.
โ > TODO: Say something about mocking of
=> sentence distance : 37
โ line 175
โ AzureTest static framework for end-to-end testing.
โ requests and how
=> sentence distance : 40
โ line 176
โ the inherent complexity. Instead, AzureTest should be used for most end-to-end scenario tests.
โ design
=> sentence distance : 90
โ line 177
โ abnormal network conditions such as dropped connectivity.
โ it.
=> sentence distance : 54
133 words added. 50 words deleted.
Added words rate 10.848287112561176% (133 / 1226 words)
Deleted words rate 4.078303425774878% (50 / 1226 words)
-
-
java
-
implementation.md : File Modified +1107 / -890 ๐ 1399
โ line 2
โ Guidelines: Implementation"
โ ๊ฐ์ด๋๋ผ์ธ: ๊ตฌํ"
=> sentence distance : 24
โ line 9
โ Implementation
โ ๊ตฌํ
=> sentence distance : 14
โ line 11
โ This section describes guidelines for implementing
โ ์ด ๋ฌธ์๋
=> sentence distance : 49
โ line 11
โ client libraries. Please note that some of these guidelines are automatically enforced by code generation tools.
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ๊ตฌํํ๊ธฐ ์ํ ๊ฐ์ด๋๋ผ์ธ์ ๋๋ค. ์ด ๊ฐ์ด๋๋ผ์ธ์ ์ผ๋ถ๋ ์ฝ๋ ์์ฑ ๋๊ตฌ์ ์ํด ์๋์ผ๋ก ์ ์ฉ๋ ์ ์ ์ ์ํ์๊ธฐ ๋ฐ๋๋๋ค.
=> sentence distance : 99
โ line 13
โ allow implementation code (that is, code that doesn't form part of the public API) to be mistaken as public API. There are two valid arrangements for implementation code, which in order of preference are the following:
โ ๊ตฌํ ์ฝ๋(์ฆ, ๊ณต๊ฐ API์ ์ผ๋ถ๋ฅผ ๊ตฌ์ฑํ์ง ์์ ์ฝ๋)๋ฅผ ๊ณต๊ฐ API๋ก ์ค์ธํ์ง ์๋๋ก ํ์ญ์์ค. ๊ตฌํ ์ฝ๋์๋ ๋ ๊ฐ์ง ์ ํจํ ์ฝ์ ์ด ์๋๋ฐ, ์ฐ์ ์์๋ ๋ค์๊ณผ ๊ฐ์ต๋๋ค:
=> sentence distance : 187
โ line 15
โ Implementation classes can be made package-private and placed within the same package as the consuming class.
โ ๊ตฌํ ํด๋์ค๋ฅผ ํจํค์ง-ํ๋ผ์ด๋น์ผ๋ก ๋ง๋ค๊ณ , ์ด๋ฅผ ์ฌ์ฉํ๋ ํด๋์ค์ ๊ฐ์ ํจํค์ง ๋ด์ ๋ฐฐ์นํ ์ ์์ต๋๋ค.
=> sentence distance : 96
โ line 16
โ Implementation classes can be placed within a subpackage named `implementation`.
โ ๊ตฌํ ํด๋์ค๋ฅผ `implementation`์ผ๋ก ๋ช ๋ช ๋ ์๋ธํจํค์ง ๋ด์ ๋ฐฐ์นํ ์ ์์ต๋๋ค.
=> sentence distance : 69
โ line 18
โ checks ensure that classes within an
โ ๊ฒ์ฌ๋
=> sentence distance : 36
โ line 18
โ package aren't exposed through public API, but it is better that the API not be public in the first place, so preferring to have package-private is the better approach where practicable.
โ ํจํค์ง ๋ด์ ํด๋์ค๊ฐ ๊ณต๊ฐ API๋ฅผ ํตํด ๋ ธ์ถ๋์ง ์๋๋ก ํ์ธํฉ๋๋ค. ํ์ง๋ง ์ฐ์ API๋ฅผ ๊ณต๊ฐ API๋ก ๊ตฌํํ์ง ์๋ ๊ฒ์ด ์ข์ผ๋ฏ๋ก, ๊ฐ๋ฅํ๋ฉด ํจํค์ง-ํ๋ผ์ด๋น์ ์ ์ฉํ๋ ๊ฒ์ด ๋ ๋ซ์ต๋๋ค.
=> sentence distance : 158
โ line 20
โ Service Client
โ ์๋น์ค ํด๋ผ์ด์ธํธ
=> sentence distance : 13
โ line 22
โ Async Service Client
โ ๋น๋๊ธฐ ์๋น์ค ํด๋ผ์ด์ธํธ
=> sentence distance : 18
โ line 24
โ include blocking calls inside async client library code. Use [BlockHound] to detect blocking calls in async APIs.
โ ๋น๋๊ธฐ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ๋ด์ ๋๊ธฐ ํจ์ ํธ์ถ์ ํฌํจํ์ง ๋ง์ญ์์ค. ๋น๋๊ธฐ API ์์ ๋๊ธฐ ํจ์ ํธ์ถ์ ๊ฐ์งํ๊ธฐ ์ํด [BlockHound]๋ฅผ ์ฌ์ฉํ์ญ์์ค.
=> sentence distance : 97
โ line 26
โ Annotations
โ ์ฃผ์
=> sentence distance : 11
โ line 28
โ Include the following annotations on the service client class. For example, this code sample shows a sample class demonstrating the use of these two annotations:
โ ์๋น์ค ํด๋ผ์ด์ธํธ ํด๋์ค์๋ ๋ค์์ ์ฃผ์์ ํฌํจํ์ญ์์ค. ์๋ฅผ ๋ค์ด, ์ด ์ฝ๋์์๋ ๋ ์ฃผ์์ ์ฌ์ฉํ๋ ์์ ํด๋์ค๋ฅผ ๋ณผ ์ ์์ต๋๋ค:
=> sentence distance : 142
โ line 41
โ Annotation
โ ์ฃผ์
=> sentence distance : 10
โ line 41
โ Location
โ ์์น
=> sentence distance : 8
โ line 41
โ Description
โ ์ค๋ช
=> sentence distance : 11
โ line 43
โ Service Client | Specifies the builder responsible for instantiating the service client, whether the API is asynchronous, and a reference back to the service interface (the interface annotated with `@ServiceInterface`). |
โ ์๋น์ค ํด๋ผ์ด์ธํธ |์๋น์ค ํด๋ผ์ด์ธํธ๋ฅผ ์ธ์คํด์คํํ๋ ๋น๋, API๊ฐ ๋น๋๊ธฐ์ธ์ง ์ฌ๋ถ, ์๋น์ค ์ธํฐํ์ด์ค(`@ServiceInterface` ์ฃผ์์ด ์๋ ์ธํฐํ์ด์ค)์ ๋ํ ์ฐธ์กฐ๋ฅผ ๋ช ์ํฉ๋๋ค.|
=> sentence distance : 186
โ line 44
โ Service Method | Placed on all methods that do network operations, regardless of whether it is a client class or not. |
โ ์๋น์ค ๋ฉ์๋ |ํด๋ผ์ด์ธํธ ํด๋์ค์ธ์ง ์ฌ๋ถ์ ๊ด๊ณ ์์ด, ๋คํธ์ํฌ ์์ ์ ์ํํ๋ ๋ชจ๋ ๋ฉ์๋์ ๋ช ์ํฉ๋๋ค.|
=> sentence distance : 103
โ line 46
โ Service Client Builder
โ ์๋น์ค ํด๋ผ์ด์ธํธ ๋น๋
=> sentence distance : 20
โ line 48
โ Annotations
โ ์ฃผ์
=> sentence distance : 11
โ line 50
โ annotation should be placed on any class that is responsible for instantiating service clients (that is, instantiating classes annotated with `@ServiceClient`). For example:
โ ์ฃผ์์ ์๋น์ค ํด๋ผ์ด์ธํธ ์ธ์คํด์คํ๋ฅผ ๋ด๋นํ๋ ํด๋์ค์ ๋ฐ๋์ ๋ช ์๋์ด์ผ ํฉ๋๋ค. (์ฆ, `@ServiceClient` ์ฃผ์์ด ์ ์ฉ๋ ํด๋์ค๋ฅผ ์ธ์คํด์คํํ๋ ํด๋์ค์ ๋ฐฐ์น๋์ด์ผ ํฉ๋๋ค.) ์์๋ ๋ค์๊ณผ ๊ฐ์ต๋๋ค:
=> sentence distance : 145
โ line 57
โ This builder states that it can build instances of `ConfigurationClient` and `ConfigurationAsyncClient`.
โ ์์ ๋น๋๋ `ConfigurationClient`์ `ConfigurationAsyncClient`์ ์ธ์คํด์ค๋ฅผ ์์ฑํ ์ ์๋ค๊ณ ๋ช ์ํฉ๋๋ค.
=> sentence distance : 76
โ line 59
โ Supporting Types
โ ์ง์ ํ์
=> sentence distance : 15
โ line 61
โ Model Types
โ ๋ชจ๋ธ ํ์
=> sentence distance : 10
โ line 63
โ Annotations
โ ์ฃผ์
=> sentence distance : 11
โ line 65
โ There are two annotations of note that should be applied on model classes, when applicable:
โ ์กฐ๊ฑด์ ํด๋นํ๋ ๊ฒฝ์ฐ, ๋ชจ๋ธ ํด๋์ค์ ์ ์ฉํด์ผ ํ๋ ๋ ๊ฐ์ง ์ฃผ์์ด ์์ต๋๋ค:
=> sentence distance : 80
โ line 67
โ annotation is applied to all model classes that are expected to provide a fluent API to end users.
โ ์ฃผ์์ ์ต์ข ์ฌ์ฉ์์๊ฒ Fluent API๋ฅผ ์ ๊ณตํ ๊ฒ์ผ๋ก ์์๋๋ ๋ชจ๋ ๋ชจ๋ธ ํด๋์ค์ ์ ์ฉ๋ฉ๋๋ค.
=> sentence distance : 84
โ line 67
โ The
โ None
=> sentence distance : None
โ line 68
โ annotation is applied to all immutable classes.
โ ์ฃผ์์ ๋ณ๊ฒฝํ ์ ์๋ ๋ชจ๋ ํด๋์ค์ ์ ์ฉ๋ฉ๋๋ค.
=> sentence distance : 41
โ line 68
โ The
โ None
=> sentence distance : None
โ line 70
โ Feature Implementation
โ ๊ธฐ๋ฅ ๊ตฌํ
=> sentence distance : 21
โ line 72
โ Logging
โ ๋ก๊น
=> sentence distance : 7
โ line 74
โ Client libraries must make use of the robust logging mechanisms in azure core, so that the consumers can adequately diagnose issues with method calls and quickly determine whether the issue is in the consumer code, client library code, or service.
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ Azure Core์ ๊ฐ๋ ฅํ ๋ก๊น ๋ฉ์ปค๋์ฆ์ ์ฌ์ฉํด์ผ ํฉ๋๋ค. ์ด๋ ์๋น์๊ฐ ๋ฉ์๋ ํธ์ถ์ ๋ฌธ์ ๋ฅผ ์ ์ ํ๊ฒ ์ง๋จํ๊ณ , ๊ทธ ๋ฌธ์ ๊ฐ ๊ฐ๋ฐ์ ์ฝ๋, ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์ฝ๋, ์๋น์ค ์ค ์ด๋์์ ๋ฐ์ํ๋์ง ํ์ธํ ์ ์๋๋ก ํ๊ธฐ ์ํจ์ ๋๋ค.
=> sentence distance : 212
โ line 78
โ None
โ id="java-logging-clientlogger" %} ๋ชจ๋ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์์๋ Azure Core๊ฐ ์ ๊ณตํ๋ `ClientLogger` API๋ฅผ ์ ์ผํ ๋ก๊น API๋ก ์ฌ์ฉํ์ญ์์ค. ๋ด๋ถ์ ์ผ๋ก, `ClientLogger`๋ [SLF4J]๋ฅผ ๊ฐ์ธ๊ณ ์์ผ๋ฏ๋ก, SLF4J๋ฅผ ํตํด ์ ๊ณต๋๋ ๋ชจ๋ ์ธ๋ถ ๊ตฌ์ฑ์ด ์ ํจํฉ๋๋ค. ์ต์ข ์ฌ์ฉ์์๊ฒ SLF4J ๊ตฌ์ฑ์ ๋ ธ์ถํ๊ธฐ๋ฅผ ๊ถ์ฅํฉ๋๋ค. ์์ธํ ๋ด์ฉ์ [SLF4J user manual]์ ์ฐธ์กฐํ์ญ์์ค.
=> sentence distance : None
โ line 80
โ create a new instance of a
โ {% include requirement/MUST-] id="java-logging-new-clientlogger" %} [-๋ชจ๋ ๊ด๋ จ ํด๋์ค์
=> sentence distance : 66
โ line 80
โ per instance of all relevant classes, except in situations where performance is critical, the instances are short-lived (and therefore the cost of unique loggers is excessive), or in
โ ์ธ์คํด์ค๋ฅผ ์์ฑํ์ญ์์ค. ๋จ, ์ฑ๋ฅ์ด ๋งค์ฐ ์ค์ํ๊ฑฐ๋, ์ธ์คํด์ค์ ์๋ช ์ด ์งง์ ๊ณ ์ ํ ๋ก๊ฑฐ๋ฅผ ์ฌ์ฉํ๊ธฐ์ ๋น์ฉ์ด ๊ณผํ๊ฑฐ๋, ํด๋์ค ์ธ์คํด์คํ๊ฐ ํ์ฉ๋์ง ์๋
=> sentence distance : 164
โ line 80
โ classes (where there is no instantiation of the class allowed). In these cases, it is acceptable to have a shared (or
โ ํด๋์ค๋ ์์ธ์ ๋๋ค. ์ด๋ฌํ ์์ธ์ ๊ฒฝ์ฐ, ๊ณต์ (๋๋
=> sentence distance : 109
โ line 80
โ logger instance. For example, the code below will create a
โ ๋ก๊ฑฐ ์ธ์คํด์ค๊ฐ ํ์ฉ๋ฉ๋๋ค. ์๋ฅผ ๋ค์ด, ์๋ ์ฝ๋๋ `ConfigurationAsyncClient`์ ๋ํ
=> sentence distance : 54
โ line 80
โ instance for the `ConfigurationAsyncClient`:
โ ์ธ์คํด์ค๋ฅผ ์์ฑํฉ๋๋ค:
=> sentence distance : 42
โ line 80
โ None
โ {% include requirement/MUST
=> sentence distance : None
โ line 95
โ Note that static loggers are shared among all client library instances running in a
โ Static ๋ก๊ฑฐ๋
=> sentence distance : 77
โ line 95
โ instance.
โ ์ธ์คํด์ค์์ ์คํ๋๋ ๋ชจ๋ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์ธ์คํด์ค ๊ฐ์ ๊ณต์ ๋๋ค๋ ์ ์ ์ฐธ๊ณ ํ์ญ์์ค.
=> sentence distance : 50
โ line 95
โ None
โ ๋ก๊ฑฐ๋ ์ธ์คํด์ค ์๋ช ์ด ์งง์ ๊ฒฝ์ฐ์๋ง ์ ์คํ ์ฌ์ฉํด์ผ ํฉ๋๋ค.
=> sentence distance : None
โ line 97
โ loggers should be used carefully and in short-lived cases only.
โ {% include requirement/MUST id="java-logging-levels" %} ๋ก๊ทธ๋ฅผ ๋ด๋ณด๋ผ ๋๋ ๋ค์ ๋ก๊ทธ ๋ ๋ฒจ ์ค ํ๋๋ฅผ ์ฌ์ฉํ์ญ์์ค: `Verbose`(์์ธ ์ ๋ณด), `Informational`(๋ฐ์ํ ์ํฉ), `Warning`(๋ฌธ์ ์ผ ์ ์๋ ์ํฉ), `Error`.
=> sentence distance : 144
โ line 99
โ id="java-logging-levels"
โ id="java-logging-errors"
=> sentence distance : 5
โ line 99
โ use one of the following log levels when emitting logs: `Verbose` (details), `Informational` (things happened), `Warning` (might be a problem or not), and `Error`.
โ `Error` ๋ ๋ฒจ์ ์์ฉ ํ๋ก๊ทธ๋จ์ด ๋ณต๊ตฌ๋ ๊ฐ๋ฅ์ฑ์ด ๊ฑฐ์ ์๋ ์ค๋ฅ(๋ฉ๋ชจ๋ฆฌ ๋ถ์กฑ ๋ฑ)์ ์ฌ์ฉํ์ญ์์ค.
=> sentence distance : 146
โ line 101
โ id="java-logging-errors"
โ id="java-logging-warn"
=> sentence distance : 5
โ line 101
โ use the `Error` logging level for failures that the application is unlikely to recover from (out of memory, etc.).
โ `Warning` ๋ ๋ฒจ์ ํจ์๊ฐ ์๋ํ ์์ ์ ์ํํ์ง ๋ชปํ ๊ฒฝ์ฐ ์ฌ์ฉํ์ญ์์ค. ์ด๋ ์ผ๋ฐ์ ์ผ๋ก ํจ์๊ฐ ์์ธ๋ฅผ ๋ฐ์์ํจ๋ค๋ ๊ฒ์ ์๋ฏธํฉ๋๋ค. ์ค์ค๋ก ๋ณต๊ตฌํ๋ ์ด๋ฒคํธ ๋ฐ์(์๋ฅผ ๋ค์ด, ์์ฒญ์ด ์๋์ผ๋ก ์ฌ์๋๋๋ ๊ฒฝ์ฐ)์ ํฌํจํ์ง ๋ง์ญ์์ค.
=> sentence distance : 117
โ line 105
โ log the request and response (see below) at the
โ ์์ฒญ/์๋ต ์ฃผ๊ธฐ(์๋ต ๋ณธ๋ฌธ ์์๊น์ง)๊ฐ ์๋น์ค ์ ์ ์๊ณ๊ณ ๊ฐ์ ์ด๊ณผํ ๋,
=> sentence distance : 42
โ line 105
โ logging level when a request/response cycle (to the start of the response body) exceeds a service-defined threshold. The threshold should be chosen to minimize false-positives and identify service issues.
โ ์์ค์์ ์์ฒญ ๋ฐ ์๋ต(์๋ ์ฐธ์กฐ)์ ๊ธฐ๋กํ ์ ์์ต๋๋ค. ์๊ณ ๊ฐ์ ๊ฑฐ์ง-๊ธ์ (false-positives)์ ์ต์ํํ๊ณ , ์๋น์ค ๋ฌธ์ ๋ฅผ ์๋ณํ๊ธฐ ์ํด ์ ํ๋์ด์ผ ํฉ๋๋ค.
=> sentence distance : 179
โ line 107
โ logging level when a function operates normally.
โ ๋ ๋ฒจ์ ํจ์๊ฐ ์ ์์ ์ผ๋ก ์๋ํ ๋ ์ฌ์ฉํ์ญ์์ค.
=> sentence distance : 42
โ line 107
โ use the
โ None
=> sentence distance : None
โ line 109
โ logging level for detailed troubleshooting scenarios. This is primarily intended for developers or system administrators to diagnose specific failures.
โ ๋ ๋ฒจ์ ์์ธํ ๋ฌธ์ ํด๊ฒฐ ์๋๋ฆฌ์ค๋ฅผ ์ํด ์ฌ์ฉํ์ญ์์ค. ์ด๋ ์ฃผ๋ก ๊ฐ๋ฐ์ ํน์ ์์คํ ๊ด๋ฆฌ์๊ฐ ํน์ ์ค๋ฅ๋ฅผ ์ง๋จํ๊ธฐ ์ํ ๊ฒ์ ๋๋ค.
=> sentence distance : 133
โ line 109
โ use the
โ None
=> sentence distance : None
โ line 111
โ only log headers and query parameters that are in a service-provided "allow-list" of approved headers and query parameters. All other headers and query parameters must have their values redacted.
โ ์น์ธ๋ ํค๋์ ์ฟผ๋ฆฌ ํ๋ผ๋ฏธํฐ์ ์๋น์ค ์ ๊ณต "ํ์ฉ ๋ชฉ๋ก"์ ์๋ ํค๋ ๋ฐ ์ฟผ๋ฆฌ ํ๋ผ๋ฏธํฐ๋ง ๋ก๊ทธ๋ก ๊ธฐ๋กํ์ญ์์ค. ๋ค๋ฅธ ๋ชจ๋ ํค๋์ ์ฟผ๋ฆฌ ํ๋ผ๋ฏธํฐ๋ ํด๋น ๊ฐ์ ์์ ํด์ผ ํฉ๋๋ค.
=> sentence distance : 171
โ line 113
โ message. The log should include the following information:
โ ๋ฉ์์ง๋ก ์์ฒญ ํ๊ณผ ํค๋๋ฅผ ๋ก๊ทธ์ ๋จ๊ธฐ์ญ์์ค. ๋ก๊ทธ๋ ๋ค์์ ์ ๋ณด๋ฅผ ํฌํจํด์ผ ํฉ๋๋ค:
=> sentence distance : 50
โ line 113
โ log request line and headers as an
โ None
=> sentence distance : None
โ line 115
โ method.
โ ๋ฉ์๋
=> sentence distance : 7
โ line 115
โ The
โ None
=> sentence distance : None
โ line 116
โ The URL.
โ URL
=> sentence distance : 5
โ line 117
โ The query parameters (redacted if not in the allow-list).
โ ์ฟผ๋ฆฌ ํ๋ผ๋ฏธํฐ(ํ์ฉ ๋ชฉ๋ก์ ์๋ ๊ฒฝ์ฐ ์์ )
=> sentence distance : 50
โ line 118
โ The request headers (redacted if not in the allow-list).
โ ์์ฒญ ํค๋(ํ์ฉ ๋ชฉ๋ก์ ์๋ ๊ฒฝ์ฐ ์์ )
=> sentence distance : 49
โ line 119
โ An SDK provided request
โ SDK๊ฐ ์๊ด ๊ด๊ณ ๋ชฉ์ ์ ์ํด ์ ๊ณตํ๋ ์์ฒญ
=> sentence distance : 23
โ line 119
โ for correlation purposes.
โ None
=> sentence distance : None
โ line 120
โ The number of times this request has been attempted.
โ ์์ฒญ์ด ์๋๋ ํ์
=> sentence distance : 50
โ line 122
โ This happens within
โ ์ด๋ ๊ธฐ๋ณธ์ ์ผ๋ก
=> sentence distance : 18
โ line 122
โ by default, but users can configure this through the builder
โ ๋ด์์ ์ํํ์ง๋ง, ์ฌ์ฉ์๊ฐ
=> sentence distance : 58
โ line 122
โ configuration setting.
โ ๊ตฌ์ฑ ๋น๋๋ฅผ ํตํด ์ค์ ํ ์ ์์ต๋๋ค.
=> sentence distance : 20
โ line 124
โ message. The format of the log should be the following:
โ ๋ฉ์์ง๋ก ์๋ต ํ๊ณผ ํค๋๋ฅผ ๋ก๊ทธ์ ๋จ๊ธฐ์ญ์์ค. ๋ก๊ทธ ํ์์ ๋ค์๊ณผ ๊ฐ์์ผ ํฉ๋๋ค:
=> sentence distance : 49
โ line 124
โ log response line and headers as an
โ None
=> sentence distance : None
โ line 126
โ The SDK provided request ID (see above).
โ SDK์์ ์ ๊ณตํ ์์ฒญ ID(์ ์ฐธ์กฐ)
=> sentence distance : 30
โ line 127
โ The status code.
โ ์ํ ์ฝ๋
=> sentence distance : 15
โ line 128
โ Any message provided with the status code.
โ ์ํ ์ฝ๋์ ํจ๊ป ์ ๊ณต๋ ๋ฉ์์ง
=> sentence distance : 38
โ line 129
โ The response headers (redacted if not in the allow-list).
โ ์๋ต ํค๋(ํ์ฉ ๋ชฉ๋ก์ ์๋ ๊ฒฝ์ฐ ์์ )
=> sentence distance : 50
โ line 130
โ The time period between the first attempt of the request and the first byte of the body.
โ ์์ฒญ์ ์ฒซ ๋ฒ์งธ ์๋์ ๋ณธ๋ฌธ์ ์ฒซ ๋ฒ์งธ ๋ฐ์ดํธ ์ฌ์ด์ ๊ธฐ๊ฐ
=> sentence distance : 79
โ line 132
โ log an
โ ์๋น์ค ์์ฒญ์ด ์ทจ์๋ ๊ฒฝ์ฐ
=> sentence distance : 13
โ line 132
โ message if a service call is cancelled. The log should include:
โ ๋ก๊ทธ๋ฅผ ๊ธฐ๋กํ์ญ์์ค. ๋ก๊ทธ์๋ ๋ค์์ด ํฌํจ๋์ด์ผ ํฉ๋๋ค:
=> sentence distance : 57
โ line 134
โ The SDK provided request ID (see above).
โ SDK์์ ์ ๊ณตํ ์์ฒญ ID(์ ์ฐธ์กฐ)
=> sentence distance : 30
โ line 135
โ The reason for the cancellation (if available).
โ ์ทจ์ ์ฌ์ (๊ฐ๋ฅํ ๊ฒฝ์ฐ)
=> sentence distance : 44
โ line 137
โ log exceptions thrown as a
โ ์์ธ๋
=> sentence distance : 26
โ line 137
โ level message. If the log level set to `Verbose`, append stack trace information to the message.
โ ๋ ๋ฒจ ๋ฉ์์ง๋ก ๊ธฐ๋กํ์ญ์์ค. ๋ก๊ทธ ๋ ๋ฒจ์ด `Verbose`๋ก ์ค์ ๋ ๊ฒฝ์ฐ, ์คํ ์ถ์ ์ ๋ณด๋ฅผ ๋ฉ์์ง์ ํฌํจํ์ญ์์ค.
=> sentence distance : 75
โ line 139
โ throw all exceptions created within the client library code through one of the logger APIs
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์ฝ๋ ๋ด์์ ๋ฐ์ํ ๋ชจ๋ ์์ธ๋ ๋ค์ ๋ก๊ฑฐ API ์ค ํ๋๋ฅผ ํตํด ๋ฐ์์ํต์์ค
=> sentence distance : 78
โ line 139
โ or
โ ํน์
=> sentence distance : 2
โ line 141
โ For example:
โ ์๋ ์์๊ฐ ์์ต๋๋ค:
=> sentence distance : 11
โ line 170
โ Distributed tracing
โ ๋ถ์ฐ ์ถ์
=> sentence distance : 18
โ line 172
โ Distributed tracing mechanisms allow the consumer to trace their code from frontend to backend. Distributed tracing libraries creates spans - units of unique work. Each span is in a parent-child relationship. As you go deeper into the hierarchy of code, you create more spans. These spans can then be exported to a suitable receiver as needed. To keep track of the spans, a _distributed tracing context_ (called a context in the remainder of this section) is passed into each successive layer. For more information on this topic, visit the [OpenTelemetry] topic on tracing.
โ ๋ถ์ฐ ์ถ์ ๋ฉ์ปค๋์ฆ์ ํตํด ์๋น์๋ ๊ทธ๋ค์ ์ฝ๋๋ฅผ ํ๋ก ํธ์๋๋ถํฐ ๋ฐฑ์๋๊น์ง ์ถ์ ํ ์ ์์ต๋๋ค. ๋ถ์ฐ ์ถ์ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ ๊ณ ์ ํ ์์ ๋จ์์ธ ๋ฒ์๋ฅผ ์์ฑํฉ๋๋ค. ๊ฐ๊ฐ์ ๋ฒ์๋ ๋ถ๋ชจ-์์ ๊ด๊ณ์ ์์ต๋๋ค. ์ฝ๋ ๊ณ์ธต ๊ตฌ์กฐ์ ๋ ๊น์ด ๋ค์ด๊ฐ์๋ก ๋ ๋ง์ ๋ฒ์๊ฐ ์์ฑ๋ฉ๋๋ค. ์ด๋ฌํ ๋ฒ์๋ ํ์์ ๋ฐ๋ผ ์ ํฉํ ์์ ์๋ก ๋ด๋ณด๋ด์ง ์ ์์ต๋๋ค. ๋ฒ์๋ฅผ ์ถ์ ํ๊ธฐ ์ํด, _๋ถ์ฐ ์ถ์ ์ปจํ ์คํธ_(์ดํ ์ปจํ ์คํธ)๋ ๊ฐ ์ฐ์ ๊ณ์ธต์ผ๋ก ์ ๋ฌ๋ฉ๋๋ค. ์์ธํ ์ ๋ณด๋ [OpenTelemetry]์ ์ถ์ ํญ๋ชฉ์ ์ฐธ์กฐํ์ญ์์ค.
=> sentence distance : 496
โ line 174
โ core library provides a service provider interface (SPI) for adding pipeline policies at runtime. The pipeline policy is used to enable tracing on consumer deployments. Pluggable pipeline policies must be supported in all client libraries to enable distributed tracing. Additional metadata can be specified on a per-service-method basis to provide a richer tracing experience for consumers.
โ Core ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ ๋ฐํ์ ์์ ์ ํ์ดํ๋ผ์ธ ์ ์ฑ ์ ์ถ๊ฐํ๊ธฐ ์ํ Service Provider Interface (SPI)๋ฅผ ์ ๊ณตํฉ๋๋ค. ํ์ดํ๋ผ์ธ ์ ์ฑ ์ ์๋น์ ๋ฐฐํฌ์์ ์ถ์ ์ ํ์ฑํํ๋ ๋ฐ ์ฌ์ฉ๋ฉ๋๋ค. ๋ถ์ฐ ์ถ์ ์ ์ฌ์ฉํ๋ ค๋ฉด ๋ชจ๋ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์์ ํ๋ฌ๊ทธํ ํ์ดํ๋ผ์ธ ์ ์ฑ ์ ์ง์ํด์ผ ํฉ๋๋ค. ์ถ๊ฐ ๋ฉํ๋ฐ์ดํฐ๋ ์๋น์ค๋ณ ๋ฉ์๋์ ๋ฐ๋ผ ์ง์ ํ์ฌ ์๋น์์๊ฒ ๋ ํ๋ถํ ์ถ์ ๊ฒฝํ์ ์ ๊ณตํ ์ ์์ต๋๋ค.
=> sentence distance : 332
โ line 176
โ pipeline instantiation. This enables developers to include a tracing plugin and have its pipeline policy automatically injected into all client libraries that they are using.
โ ํ์ดํ๋ผ์ธ ์ธ์คํด์คํ์ ์ผ๋ถ๋ก์จ ํ๋ฌ๊ทธํ ํ์ดํ๋ผ์ธ ์ ์ฑ ์ ์ง์ํ์ญ์์ค. ์ด๋ฅผ ํตํด ๊ฐ๋ฐ์๋ ์ถ์ ํ๋ฌ๊ทธ์ธ์ ํฌํจํ๊ณ , ํด๋น ํ์ดํ๋ผ์ธ ์ ์ฑ ์ ์ฌ์ฉ ์ค์ธ ๋ชจ๋ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ์๋์ผ๋ก ์ฃผ์ ํ ์ ์์ต๋๋ค.
=> sentence distance : 151
โ line 176
โ support pluggable pipeline policies as part of the
โ None
=> sentence distance : None
โ line 178
โ Review the code sample below, in which a service client builder creates an `HttpPipeline` from its set of policies. At the same time, the builder allows plugins to add 'before retry' and 'after retry' policies with the lines
โ ์๋์ ์์ ์ฝ๋๋ฅผ ๊ฒํ ํด๋ณด์ญ์์ค. ์ด ์ฝ๋์์๋ ์๋น์ค ํด๋ผ์ด์ธํธ ๋น๋๊ฐ ํด๋น ์ ์ฑ ์ `HttpPipeline`์ ์์ฑํ๊ณ ์์ต๋๋ค. ๋์์, ๋น๋๋
=> sentence distance : 195
โ line 178
โ and `HttpPolicyProviders.addAfterRetryPolicies(policies)`:
โ ๋ฐ `HttpPolicyProviders.addAfterRetryPolicies(policies)` ํ์ ์ฌ์ฉํ์ฌ ํ๋ฌ๊ทธ์ธ์ด โbefore retryโ์ โafter retryโ ์ ์ฑ ์ ์ถ๊ฐํ ์ ์๋๋ก ํ์ฉํฉ๋๋ค:
=> sentence distance : 67
โ line 201
โ use the
โ ์ถ์ ๋ฒ์์ ํจ๊ป ์ ๊ณตํด์ผ ํ๋ ์ถ๊ฐ ๋ฉํ๋ฐ์ดํฐ๋ฅผ ์ค์ ํ๋ ค๋ฉด
=> sentence distance : 32
โ line 201
โ core
โ Core
=> sentence distance : 1
โ line 201
โ API to set additional metadata that should be supplied along with the tracing span. In particular, use the
โ API๋ฅผ ์ฌ์ฉํ์ญ์์ค. ํนํ
=> sentence distance : 100
โ line 201
โ method to set a new key/value pair on the tracing context.
โ ๋ฉ์๋๋ฅผ ์ฌ์ฉํ์ฌ ์ถ์ ์ปจํ ์คํธ์์ ์ ํค/๊ฐ ์์ ์ค์ ํฉ๋๋ค.
=> sentence distance : 50
โ line 203
โ pass all
โ ์๋น์ค ๋ฉ์๋ ์ธ์๋ก ๋ฐ์
=> sentence distance : 13
โ line 203
โ objects received as service method arguments through to the generated service interface methods in all cases.
โ ๊ฐ์ฒด ์ ๋ถ๋ฅผ ๋ชจ๋ ๊ฒฝ์ฐ์ ์์ฑ๋ ์๋น์ค ์ธํฐํ์ด์ค ๋ฉ์๋๋ก ์ ๋ฌํ์ญ์์ค.
=> sentence distance : 100
โ line 205
โ Testing
โ ํ ์คํ
=> sentence distance : 7
โ line 207
โ parameterize all applicable unit tests to make use of all available
โ ์ฌ์ฉ ๊ฐ๋ฅํ ๋ชจ๋
=> sentence distance : 65
โ line 207
โ clients and service versions. Parameterized runs of all tests must occur as part of live tests. Shorter runs, consisting of just Netty and the latest service version, can be run whenever
โ ํด๋ผ์ด์ธํธ์ ์๋น์ค ๋ฒ์ ์ ์ฌ์ฉํ๋ ค๋ฉด, ์ ์ฉ ๊ฐ๋ฅํ ๋ชจ๋ ๋จ์ ํ ์คํธ๋ฅผ ๋งค๊ฐ๋ณ์ํํ์ญ์์ค. ๋ชจ๋ ํ ์คํธ์ ๋งค๊ฐ๋ณ์ํ๋ ์คํ์ ๋ผ์ด๋ธ ํ ์คํธ์ ์ผ๋ถ๋ก ์ด๋ฃจ์ด์ ธ์ผ ํฉ๋๋ค. Netty์ ์ต์ ์๋น์ค ๋ฒ์ ์ผ๋ก ๊ตฌ์ฑ๋ ๋ ์งง์ ์คํ์
=> sentence distance : 156
โ line 207
โ validation occurs.
โ ์ ํจ์ฑ ๊ฒ์ฌ๊ฐ ๋ฐ์ํ ๋๋ง๋ค ์คํํ ์ ์์ต๋๋ค.
=> sentence distance : 25
โ line 209
โ TODO
โ **TODO(์ถ๊ฐ ์์ )**
=> sentence distance : 11
1107 words added. 890 words deleted.
Added words rate 79.12794853466762% (1107 / 1399 words)
Deleted words rate 63.6168691922802% (890 / 1399 words)
-
introduction.md : File Modified +106 / -69 ๐ 12214
โ line 543
โ The service client will have methods that send requests to the service. These
โ Service
=> sentence distance : 71
โ line 543
โ sent
โ directly passed
=> sentence distance : 13
โ line 543
โ service as URL segments, query parameters, request header values, and request bodies (typically JSON or XML).
โ service.
=> sentence distance : 101
โ line 543
โ are not sent
โ aren't passed directly
=> sentence distance : 14
โ line 543
โ service; examples are path parameters, Context or file paths. If, for example, a path parameter is not validated, it could result in sending a request to a malformed URL, which could prevent the service from having the opportunity to do validation on it.
โ service.
=> sentence distance : 246
โ line 543
โ solely
โ None
=> sentence distance : None
โ line 545
โ This includes checks for null values for required path parameters, and checks for empty string values if a required path parameter declares a `minLength` greater than zero.
โ None
=> sentence distance : None
โ line 549
โ service.
โ Common parameter validations include null checks, empty string checks, and range checks. Let the service validate its parameters.-]{% include requirement/MUST id="java-params-test-devex" %} test the developer experience when invalid service parameters are passed in. Ensure clear error messages are generated by the [-client.
=> sentence distance : 317
โ line 549
โ None
โ Common parameter validations include null checks, empty string checks, and range checks. Let the service validate its parameters.
=> sentence distance : None
โ line 1227
โ circumstances.
โ circumstnaces.
=> sentence distance : 2
106 words added. 69 words deleted.
Added words rate 0.8678565580481415% (106 / 12214 words)
Deleted words rate 0.5649254953332241% (69 / 12214 words)
-
spring.md : File Modified +553 / -418 ๐ 553
โ line 2
โ "Spring Guidelines"
โ "์คํ๋ง ๊ฐ์ด๋๋ผ์ธ"
=> sentence distance : 16
โ line 9
โ Providing the Spring ecosystem with a first-class experience is of the utmost importance. The guidelines below are in addition to the [standard Java design guidelines](https://azure.github.io/azure-sdk/java_introduction.html), overriding the guidance as appropriate.
โ ์คํ๋ง ์ํ๊ณ์ ์ต์์ ํ๊ฒฝ์ ์ ๊ณตํ๋ ๊ฒ์ ๋งค์ฐ ์ค์ํฉ๋๋ค. ์๋ ๊ฐ์ด๋๋ผ์ธ์ [์๋ฐ ํ์ค ๋์์ธ ๊ฐ์ด๋๋ผ์ธ](https://azure.github.io/azure-sdk/java_introduction.html) ์ ์ง์นจ์ ์ ์ ํ ์ฌ์ ์ํ์ฌ ํ์ฅํ ๊ฒ์ ๋๋ค.
=> sentence distance : 186
โ line 11
โ Namespaces
โ ๋ค์์คํ์ด์ค
=> sentence distance : 10
โ line 13
โ ensure all Java packages are named using the form `com.azure.spring.. [. ]`.
โ ๋ชจ๋ ์๋ฐ ํจํค์ง๋ค์ `com.azure.spring.. [. ]`๊ณผ ๊ฐ์ ํ์์ผ๋ก ๋ช ๋ช ๋์ด์ผ ํฉ๋๋ค.
=> sentence distance : 65
โ line 15
โ use the same group, service, and feature naming as is used by the underlying Java client library.
โ ๊ทธ๋ฃน, ์๋น์ค, ๊ธฐ๋ฅ์ ์๋ฐ ๊ธฐ๋ณธ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ์ฌ์ฉ๋๋ ๊ฒ๊ณผ ๋์ผํ๊ฒ ๋ช ๋ช ํฉ๋๋ค.
=> sentence distance : 84
โ line 17
โ put all non-public API under an
โ ๋ชจ๋ ๋ ผ-ํผ๋ธ๋ฆญ API๋ ๋ฃจํธ ๋ค์์คํ์ด์ค์ ์ํ
=> sentence distance : 28
โ line 17
โ package under the root namespace.
โ ํจํค์ง์ ์์น์ํต๋๋ค.
=> sentence distance : 31
โ line 21
โ use the group ID of `com.azure.spring`.
โ ๊ทธ๋ฃน ID๋ `com.azure.spring`๋ฅผ ์ฌ์ฉํฉ๋๋ค.
=> sentence distance : 23
โ line 23
โ to be of the form `azure-spring-boot-starter-- [- ]`, for example,
โ ๋ `azure-spring-boot-starter-- [- ]`์ ํํ๋ก ์ง์ ํฉ๋๋ค.
=> sentence distance : 28
โ line 23
โ specify the
โ None
=> sentence distance : None
โ line 23
โ None
โ]`, for example,+} `azure-spring-boot-starter-storage-blob` [-๋๋ `azure-spring-boot-starter-security-keyvault-secrets`์ ๊ฐ์ ์์๊ฐ ์์ต๋๋ค.
=> sentence distance : None
โ line 24
โ None
โ ์คํ๋ง ๋ฐ์ดํฐ ์ถ์ํ์ ๊ฒฝ์ฐ, `artifactId`๋ `azure-spring-data-- [- ]`์ ๊ฐ์ ํ์์ด์ด์ผ ํฉ๋๋ค.
=> sentence distance : None
โ line 25
โ or `azure-spring-boot-starter-security-keyvault-secrets`.
โ ์คํ๋ง ํด๋ผ์ฐ๋ ์คํํฐ์ ๊ฒฝ์ฐ, `artifactId`๋ `azure-spring-cloud-starter-- [- ]`์ ๊ฐ์ ํ์์ด์ด์ผ ํฉ๋๋ค.
=> sentence distance : 71
โ line 29
โ include a
โ Azure ์คํ๋ง ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ์ฌ์ฉํ๋ ์ฌ์ฉ์๊ฐ ๋ฒ์ ์ ์ ํํ ํ์ ์์ด ๋ค๋ฅธ Azure ์๋ฐ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์์ ์ถ๊ฐ์ ์ธ ์ข ์์ฑ๋ค์ ๊ฐ์ ธ์ฌ ์ ์๋๋ก
=> sentence distance : 84
โ line 29
โ dependency on the
โ ์ข ์์ฑ์
=> sentence distance : 17
โ line 29
โ Java
โ ์๋ฐ
=> sentence distance : 4
โ line 29
โ BOM, so that users who use Azure Spring libraries can bring in additional dependencies on other Azure Java client libraries without needing to choose versions.
โ BOM์ ํฌํจํฉ๋๋ค.
=> sentence distance : 154
โ line 31
โ Versioning
โ ๋ฒ์ ๊ด๋ฆฌ
=> sentence distance : 10
โ line 33
โ Spring Cloud for Azure modules must be versioned in a way that enables the following goals:
โ ์คํ๋ง ์ธํฐ๊ทธ๋ ์ด์ ๋ชจ๋ ๋ฒ์ ๊ด๋ฆฌ๋ ์๋ ๋ชฉํ๋ค์ ์คํํ๋๋ก ์ด๋ค์ ธ์ผ ํฉ๋๋ค.
=> sentence distance : 82
โ line 35
โ Each Spring Cloud for Azure module must be able to release at different release cadences.
โ ๊ฐ๊ฐ์ ์คํ๋ง ์ธํฐ๊ทธ๋ ์ด์ ๋ชจ๋์ ๋ค๋ฅธ ๋ฆด๋ฆฌ์ค ์ผ์ด๋์ค์์๋ ๋ฆด๋ฆฌ์ค๊ฐ ๊ฐ๋ฅํด์ผ ํฉ๋๋ค.
=> sentence distance : 79
โ line 36
โ Each Spring Cloud for Azure module must have full semantic versioning for major, minor, and patch versions, in all releases. Versioning must not be tied to the Spring dependency version as in earlier iterations of the
โ ๊ฐ๊ฐ์ ์คํ๋ง ์ธํฐ๊ทธ๋ ์ด์ ๋ชจ๋์ ๋ชจ๋ ๋ฆด๋ฆฌ์ค์์ ์ฃผ ๋ฒ์ , ๋ถ ๋ฒ์ , ํจ์น ๋ฒ์ ์ด ๋ชจ๋ ํฌํจ๋ ์ ์์ ๋ฒ์ ์ ๊ฐ์ ธ์ผ ํฉ๋๋ค.
=> sentence distance : 198
โ line 36
โ Spring Cloud for Azure modules.
โ ์คํ๋ง ์ธํฐ๊ทธ๋ ์ด์ ๋ชจ๋์์ ๊ทธ๋ฌ๋ ๊ฒ์ฒ๋ผ, ๋ฒ์ ๊ด๋ฆฌ๊ฐ ์คํ๋ง ์ข ์์ฑ ๋ฒ์ ์ ์ฐ๊ฒฐ๋์ด ์ด๋ค์ง๋ฉด ์ ๋ฉ๋๋ค.
=> sentence distance : 55
โ line 37
โ Allow developers to easily choose Spring Cloud for Azure modules which work together.
โ ๊ฐ๋ฐ์๋ค์ด ์ฌ์ฉํ ์คํ๋ง ์ธํฐ๊ทธ๋ ์ด์ ๋ชจ๋์ ์ฝ๊ฒ ์ ํํ ์ ์๋๋ก ํด์ผ ํฉ๋๋ค.
=> sentence distance : 74
โ line 39
โ ensure that all releases of a Spring Cloud for Azure module support all active versions (as of the time of release) of the corresponding Spring API.
โ ๋ชจ๋ ์คํ๋ง ์ธํฐ๊ทธ๋ ์ด์ ๋ชจ๋์, ๋ฆด๋ฆฌ์ค ์์ ์ ๊ธฐ์ค์ผ๋ก, ์์ํ๋ ๋ชจ๋ ์คํ๋ง API ํ์ฑ ๋ฒ์ ๋ค์ ์ง์ํฉ๋๋ค.
=> sentence distance : 134
โ line 41
โ add latest release version of Spring
โ ์ต์ ๋ฆด๋ฆฌ์ค ๋ฒ์ ์ ์คํ๋ง
=> sentence distance : 33
โ line 41
โ dependencies in the Spring Cloud for Azure module
โ ์ข ์์ฑ์ ์คํ๋ง ์ธํฐ๊ทธ๋ ์ด์ ๋ชจ๋
=> sentence distance : 46
โ line 41
โ files, it is the users responsibility to override the Spring
โ ํ์ผ์ ์ถ๊ฐํฉ๋๋ค. ์ฌ์ฉ์๋ค์ ์ค์ค๋ก ์คํ๋ง BOM์ ํตํด ์คํ๋ง
=> sentence distance : 54
โ line 41
โ version via Spring BOM.
โ ๋ฒ์ ์ ์ฌ์ ์ํด์ผ ํฉ๋๋ค.
=> sentence distance : 20
โ line 43
โ add Maven classifiers to releases if a Spring Cloud for Azure module cannot support all active versions of the corresponding Spring API. For example, if a Spring Cloud for Azure module needs to support
โ ์คํ๋ง ์ธํฐ๊ทธ๋ ์ด์ ๋ชจ๋์ด ๋ชจ๋ ์คํ๋ง API ํ์ฑ ๋ฒ์ ๋ค์ ์ง์ํ ์ ์๋ ๊ฒฝ์ฐ ๋ฆด๋ฆฌ์ค์ ๋ฉ์ด๋ธ ๋ถ๋ฅ์๋ฅผ ์ถ๊ฐํฉ๋๋ค. ์๋ฅผ ๋ค์ด ์คํ๋ง ์ธํฐ๊ทธ๋ ์ด์ ๋ชจ๋์ด
=> sentence distance : 180
โ line 43
โ None
โ 2.2x์ 2.3.x์ ์ง์ํด์ผ ํ์ง๋ง ๊ธฐ์ ์ ์ธ ์ ์ฝ์ผ๋ก ์ง์ํ์ง ๋ชปํ๋ ๊ฒฝ์ฐ
=> sentence distance : None
โ line 44
โ 2.2.x and 2.3.x, but cannot due to technical contraints, two versions of the Spring Cloud for Azure module must be released, with classifiers `springboot_2_2` and `springboot_2_3`.
โ `springboot_2_2`์ `springboot_2_3` ๋ถ๋ฅ์๊ฐ ์๋ ๋ ๊ฐ์ง ๋ฒ์ ์ ์คํ๋ง ์ธํฐ๊ทธ๋ ์ด์ ๋ชจ๋์ด ๋ฆด๋ฆฌ์ค ๋ผ์ผ ํฉ๋๋ค.
=> sentence distance : 156
โ line 46
โ provide a Spring Cloud for
โ ์ฌ์ฉ์๋ค์ ์ํด ์คํ๋ง ์ธํฐ๊ทธ๋ ์ด์ ๋ชจ๋ BOM์ ์ ๊ณตํฉ๋๋ค. ์ด BOM์ ๊ฐ์ด ๋์ํ๋ ๊ฒ์ผ๋ก ์๋ ค์ง ๋ชจ๋ ์คํ๋ง ์ธํฐ๊ทธ๋ ์ด์ ๋ชจ๋๋ค์ ๋ฒ์ ์ ๋ฐ๋์ ํฌํจํด์ผ ํฉ๋๋ค(์ข ์์ฑ ๋ฒ์ ๋ค์ ๋ํ ๋จ์ผ ์งํฉ์ ํฌํจํด์ผ ํฉ๋๋ค). ๋ํ
=> sentence distance : 122
โ line 46
โ modules BOM for users. This BOM must contain versions of all Spring Cloud for Azure modules that are known to work together (and have a single set of dependency versions). It must also include appropriate references to Azure Java SDK.
โ ์๋ฐ SDK์ ๋ํ ์ ์ ํ ์ฐธ์กฐ ์ญ์ ํฌํจ๋ผ์ผ ํฉ๋๋ค.
=> sentence distance : 225
โ line 48
โ encourage users to use the Spring Cloud for Azure modules BOM for their chosen version of Spring rather than specific versions of each Spring Cloud for Azure module, such that they need not worry about Maven classifiers and other versioning issues.
โ ์ฌ์ฉ์๋ค์ด ๋ฉ์ด๋ธ ๋ถ๋ฅ์๋ ๊ธฐํ ๋ฒ์ ๊ด๋ฆฌ ๋ฌธ์ ๋ค์ ์ ๊ฒฝ์ฐ์ง ์๋๋ก ๊ทธ๋ค์ด ์ ํํ ์คํ๋ง ๋ฒ์ ์ ๋ํด, ํน์ ๋ฒ์ ์ ์คํ๋ง ์ธํธ๊ทธ๋ ์ด์ ๋ชจ๋์ ์ฌ์ฉํ๊ธฐ ๋ณด๋ค๋, ์คํ๋ง ์ธํฐ๊ทธ๋ ์ด์ ๋ชจ๋ BOM์ ์ฌ์ฉํ ๊ฒ์ ๊ถ์ฅํฉ๋๋ค.
=> sentence distance : 218
โ line 50
โ Dependencies
โ ์ข ์์ฑ
=> sentence distance : 12
โ line 52
โ introduce dependencies on libraries, or change dependency versions, without discussion with the Java architect. Each dependency must receive explicit approval and be added to the dependency allow list before it may be used.
โ ์๋ฐ ์ค๊ณ์์์ ๋ ผ์ ์์ด ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ๋ํ ์ข ์์ฑ์ ๋์ ํ๊ฑฐ๋, ์ข ์์ฑ ๋ฒ์ ์ ๋ณ๊ฒฝํฉ๋๋ค. ๊ฐ ์ข ์์ฑ์ ์ฌ์ฉํ๊ธฐ ์ ์ ๋ฐ๋์ ๋ช ์์ ์ธ ์น์ธ์ ๋ฐ๊ณ ์ข ์์ฑ ํ์ฉ ๋ชฉ๋ก์ ์ถ๊ฐ๋ผ์ผ ํฉ๋๋ค.
=> sentence distance : 198
โ line 54
โ introduce dependencies on library versions that conflict with the transitive dependencies of Spring libraries.
โ ์คํ๋ง ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ์ ์ด์ ์ข ์์ฑ๋ค๊ณผ ์ถฉ๋ํ๋ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ๋ฒ์ ๋ค์ ๋ํด ์ข ์์ฑ์ ๋์ ํฉ๋๋ค.
=> sentence distance : 100
โ line 56
โ client libraries only
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ง ์ฌ์ฉํด์ผ ํฉ๋๋ค
=> sentence distance : 21
โ line 56
โ do not mix older
โ ์ข ์์ฑ ๊ณ์ธต ๊ตฌ์กฐ์์ ๊ตฌ ๋ฒ์ ์ธ
=> sentence distance : 15
โ line 56
โ client libraries into the dependency hierarchy.
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ํผ์ฉํ์ง ๋ง์ญ์์ค.
=> sentence distance : 43
โ line 56
โ make use of
โ None
=> sentence distance : None
โ line 58
โ keep dependencies to the minimal required set.
โ ์ต์ํ์ ์๊ตฌ์ฌํญ์ ๋ํ ์ข ์์ฑ๋ค์ ์ ์งํด์ผ ํฉ๋๋ค.
=> sentence distance : 40
โ line 60
โ Logging
โ ๋ก๊น
=> sentence distance : 7
โ line 62
โ logging APIs.
โ ๋ก๊น API๋ฅผ ์ฌ์ฉํด์ผ ํฉ๋๋ค.
=> sentence distance : 15
โ line 62
โ use the
โ None
=> sentence distance : None
โ line 64
โ Tracing
โ ์ถ์
=> sentence distance : 7
โ line 66
โ ensure that all
โ ๋ชจ๋
=> sentence distance : 15
โ line 66
โ Spring libraries fully integrate with the tracing capabilities available in the
โ ์คํ๋ง ๋ผ์ด๋ธ๋ฌ๋ฆฌ๊ฐ
=> sentence distance : 78
โ line 66
โ Java client libraries.
โ ์๋ฐ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์์ ์ฌ์ฉ ๊ฐ๋ฅํ ์ถ์ ๊ธฐ๋ฅ๋ค๊ณผ ์์ ํ ํตํฉ๋๋์ง ํ์ธํฉ๋๋ค.
=> sentence distance : 45
โ line 68
โ ensure that all
โ ๋ชจ๋
=> sentence distance : 15
โ line 68
โ Spring libraries work appropriately with Spring Sleuth, and that tracing information is appropriately exported.
โ ์คํ๋ง ๋ผ์ด๋ธ๋ฌ๋ฆฌ๊ฐ ์คํ๋ง Sleyth์ ์ ์ ํ๊ฒ ๋์ํ๊ณ , ์ถ์ ์ ๋ณด๊ฐ ์ ์ ํ๊ฒ ๋ด๋ณด๋ด์ก๋์ง ํ์ธํฉ๋๋ค.
=> sentence distance : 96
โ line 70
โ Performance
โ ์ฑ๋ฅ
=> sentence distance : 11
โ line 72
โ ensure, through appropriate benchmarks (developed in conjuction with the Java SDK team) that performance of all Spring libraries is at an equivalent level to the same operation being performed directly through the Java client library.
โ ์ ์ ํ ๋ฒค์น๋งํฌ๋ค(์๋ฐ SDKํ๊ณผ ๊ณต๋์ผ๋ก ๊ฐ๋ฐ)์ ํตํด ๋ชจ๋ ์คํ๋ง ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ์ฑ๋ฅ์ด ์๋ฐ ํด๋ผ์ด์ธํธ์์ ์ง์ ์คํํ๋ ๋์ผํ ์์ ๊ณผ ๋๋ฑํ ์์ค์ธ์ง ํ์ธํฉ๋๋ค.
=> sentence distance : 211
</details>553 words added. 418 words deleted.
Added words rate 100.0% (553 / 553 words)
Deleted words rate 75.5877034358047% (418 / 553 words)
-
-
policies
-
adoption.md : File Modified +623 / -447 ๐ 499
โ line 2
โ "Policies: Guideline Adoption"
โ "์ ์ฑ : ๋์ ๊ฐ์ด๋๋ผ์ธ"
=> sentence distance : 25
โ line 8
โ The design guidelines are meant to be much like the US constitution - a document that everyone can abide by and follow, but not one that is easy to adjust. As a result, the following policy affects how we can change the design guidelines.
โ ์ค๊ณ ๊ฐ์ด๋๋ผ์ธ์ ๋ฏธ๊ตญ ํ๋ฒ๊ณผ -๋ชจ๋ ์ฌ๋์ด ์ค์ํ๊ณ ๋ฐ๋ฅผ ์ ์์ง๋ง ์ฝ๊ฒ ์กฐ์ ํ ์ ์๋ ๋ฌธ์๋ ์๋๋ผ๋ ์ ์์-๋งค์ฐ ์ ์ฌํฉ๋๋ค. ๊ทธ ๊ฒฐ๊ณผ, ์ดํ์ ๋ฐฉ์นจ์ด ์ค๊ณ ๊ฐ์ด๋ ๋ผ์ธ์ ๋ณ๊ฒฝํ๋ ๋ฐฉ๋ฒ์ ์ํฅ์ ์ค ์ ์์ต๋๋ค.
=> sentence distance : 206
โ line 10
โ Changing the general design guidelines
โ ์ผ๋ฐ์ ์ธ ์ค๊ณ ์ง์นจ ๋ณ๊ฒฝ
=> sentence distance : 35
โ line 12
โ Any change to the general design guidelines (which includes everything under the `/docs/general` folder within the `azure/azure-sdk` repository) should be "a big deal" since such changes affect every single client library that we produce. The following requirements must be met before a general design guideline is adopted:
โ ์ผ๋ฐ์ ์ธ ์ค๊ณ ๊ฐ์ด๋๋ผ์ธ(azure/azure-sdk ์ ์ฅ์ ๋ด์ /docs/general ํด๋ ์๋์ ์๋ ๋ชจ๋ ๋ด์ฉ ํฌํจํ๋)์ ๋ณ๊ฒฝ์ ๊ทธ๋ฌํ ๋ณ๊ฒฝ์ด ์์ฑํ๋ ๋ชจ๋ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ์ํฅ์ ๋ฏธ์น๊ธฐ ๋๋ฌธ์ "ํฐ ์ผ"์ด ๋ ๊ฒ์ ๋๋ค. ์ผ๋ฐ์ ์ธ ์ค๊ณ ์ง์นจ์ ์ฑํํ๊ธฐ ์ ์ ๋ค์ ์๊ฑด์ด ์ถฉ์กฑ๋์ด์ผ ํฉ๋๋ค.
=> sentence distance : 270
โ line 14
โ The design guideline is discussed within an Architectural Board meeting with a quorum of 3 voting members of the architecture board. Each voting member may vote as follows:
โ ์ค๊ณ ๊ฐ์ด๋๋ผ์ธ์ ์ํคํ ์ฒ ์ด์ฌํ์ 3๋ช ์ ์๊ฒฐ๊ถ ๋ฉค๋ฒ๋ก ๊ตฌ์ฑ๋ ์ํคํ ์ฒ ์ด์ฌํ์์ ๋ ผ์๋ฉ๋๋ค. ๊ฐ ํฌํ ๊ตฌ์ฑ์์ ๋ค์๊ณผ ๊ฐ์ด ํฌํํ ์ ์์ต๋๋ค.
=> sentence distance : 155
โ line 15
โ Approve
โ ์น์ธ
=> sentence distance : 7
โ line 15
โ the architect believes this is a good guideline.
โ ์ค๊ณ์๋ ์ด๊ฒ์ด ์ข์ ์ง์นจ์ด๋ผ๊ณ ์๊ฐํฉ๋๋ค.
=> sentence distance : 43
โ line 16
โ Abstain
โ ์์
=> sentence distance : 7
โ line 16
โ the architect feels the guideline has flaws, but not enough to stop the proposal.
โ ์ค๊ณ์๋ ๊ฐ์ด๋๋ผ์ธ์ ๊ฒฐํจ์ด ์๋ค๊ณ ์๊ฐํ์ง๋ง ์ ์์ ๋ฉ์ถ ๋งํผ ์ถฉ๋ถํ์ง๋ ์์ต๋๋ค.
=> sentence distance : 71
โ line 17
โ Reject
โ ๊ฑฐ๋ถ
=> sentence distance : 6
โ line 17
โ the architect feels the guideline is flawed enough it must not be added to the guidelines.
โ ์ค๊ณ์๋ ๊ฐ์ด๋๋ผ์ธ์ ์ถ๊ฐํด์๋ ์ ๋ ์ ๋๋ก ๊ฐ์ด๋๋ผ์ธ์ ๊ฒฐํจ์ด ์๋ค๊ณ ์๊ฐํฉ๋๋ค.
=> sentence distance : 80
โ line 18
โ Two thirds of voting members must vote "Approve".
โ ํฌํ ๋ฉค๋ฒ์ 3๋ถ์ 2๊ฐ "์ฐฌ์ฑ"์ ํฌํํด์ผ ํฉ๋๋ค.
=> sentence distance : 43
โ line 19
โ There must be no "Reject" votes.
โ "๊ฑฐ๋ถ" ํ๊ฐ ์์ด์ผ ํฉ๋๋ค.
=> sentence distance : 28
โ line 20
โ The proposed language for the design guideline is submitted via PR.
โ ์ค๊ณ ๊ฐ์ด๋๋ผ์ธ์ ๋ํด ์ ์๋ ์ธ์ด๋ PR์ ํตํด ์ ์ถ๋ฉ๋๋ค.
=> sentence distance : 59
โ line 21
โ Review by any appropriate groups (as determined by the board chair)
โ ์ ์ ํ ๊ทธ๋ฃน(์ด์ฌํ ์์ฅ์ ๊ฒฐ์ ์ ๋ฐ๋ผ)์ ์ํ ๊ฒํ
=> sentence distance : 61
โ line 21
โ examples: Security, CSS.
โ ์: ๋ณด์, CSS
=> sentence distance : 17
โ line 22
โ Review by at least two affected service teams in different groups.
โ ์๋ก ๋ค๋ฅธ ๊ทธ๋ฃน์ ์ํ ์ํฅ์ ๋ฐ๋ ์๋น์ค ํ 2๊ฐ ์ด์์ ์ํ ๊ฒํ .
=> sentence distance : 56
โ line 23
โ Approval (through the PR process) by 3 voting members of the board.
โ (PR ํ๋ก์ธ์ค๋ฅผ ํตํด) ์ด์ฌํ์ 3๋ช ์ ํฌํ ๋ฉค๋ฒ์ ์ํ ์น์ธ.
=> sentence distance : 56
โ line 25
โ Changing the language specific guidelines
โ ์ธ์ด๋ณ ๊ฐ์ด๋๋ผ์ธ ๋ณ๊ฒฝ
=> sentence distance : 39
โ line 27
โ Language specific guidelines (which includes everything under the language-specific folder of `/docs` in the `azure/azure-sdk` repository) are generally driven by the general guidelines, but also idiomatic and generally accepted design and implementation principals in the language of choice. Design guidelines must meet the spirit of the general design guidelines. Implementation guidelines are governed by the language team, with the language architect having responsibility for ensuring the implementation guidelines meet the best practices for the language concerned.
โ ์ธ์ด ๊ณ ์ ์ ๊ฐ์ด๋๋ผ์ธ(azure/azure-sdk ์ ์ฅ์์ /docs ์ธ์ด ๊ณ ์ ์ ํด๋ ์๋์ ์๋ ๋ชจ๋ ๊ฒ์ ํฌํจํ๋ค)์ ์ผ๋ฐ์ ์ผ๋ก ์ผ๋ฐ์ ์ธ ๊ฐ์ด๋๋ผ์ธ์ ๋ฐ๋ผ ๊ฒฐ์ ๋๋ฉฐ, ์ผ๋ฐ์ ์ธ ์ธ์ด์์ ์์ฐ์ค๋ฝ๊ฒ ๋ฐ์๋ค์ฌ์ง๋ ์ค๊ณ ๋ฐ ๊ตฌํ ์์น์๋ ๋ฐ๋ผ ๊ฒฐ์ ๋ฉ๋๋ค. ์ค๊ณ ๊ฐ์ด๋๋ผ์ธ์ ์ผ๋ฐ์ ์ธ ์ค๊ณ ๊ฐ์ด๋๋ผ์ธ์ ์ ์ ์ ์ถฉ์กฑํด์ผ ํฉ๋๋ค. ์ค์ฅ ๊ฐ์ด๋๋ผ์ธ์ ์ธ์ด ํ์ ์ํด ๊ด๋ฆฌ๋๋ฉฐ, ์ธ์ด ์ค๊ณ์๋ ์ค์ฅ ๊ฐ์ด๋๋ผ์ธ์ด ํด๋น ์ธ์ด์ ์ต์ ์ ์ถฉ์กฑํ๋์ง ํ์ธํ ์ฑ ์์ด ์์ต๋๋ค.
=> sentence distance : 504
โ line 29
โ Guidelines can be proposed by anyone via PR, but the following must be met to be merged:
โ ๊ฐ์ด๋๋ผ์ธ์ ๋๊ตฌ๋ PR์ ํตํด ์ ์ํ ์ ์์ง๋ง ๋ณํฉํ๋ ค๋ฉด ๋ค์ ์ฌํญ์ ์ถฉ์กฑํด์ผ ํฉ๋๋ค.
=> sentence distance : 77
โ line 31
โ PR is approved (through the PR process) by the assigned language architect. If the updated guidelines affect the design principles or the
โ PR์ (PR ํ๋ก์ธ์ค๋ฅผ ํตํด) ์ง์ ๋ ์ธ์ด ์ค๊ณ์์ ์ํด ์น์ธ๋ฉ๋๋ค. ์ ๋ฐ์ดํธ๋ ๊ฐ์ด๋๋ผ์ธ์ด ์ค๊ณ ์์น์ด๋
=> sentence distance : 121
โ line 31
โ design sections, then a second member of the architecture board must also approve the PR.
โ ์ค๊ณ ์น์ ์ ์ํฅ์ ๋ฏธ์น๋ ๊ฒฝ์ฐ ์ํคํ ์ฒ ๋ณด๋[์ด์ฌํ]์ ๋ ๋ฒ์งธ ๋ฉค๋ฒ๋ PR์ ์น์ธํด์ผ ํฉ๋๋ค.
=> sentence distance : 77
โ line 32
โ PR is reviewed with relevant stake holders (such as service teams, security, and CSS).
โ PR์ ๊ด๋ จ ๊ด๊ณ์(์๋น์ค ํ, ๋ณด์, CSS ๋ฑ)์ ํจ๊ป ๊ฒํ ๋ฉ๋๋ค.
=> sentence distance : 75
โ line 33
โ PR is approved by the language dev lead.
โ PR์ Language Dev Lead์ ์ํด ์น์ธ๋ฉ๋๋ค.
=> sentence distance : 31
โ line 35
โ Engineering systems policy changes
โ ์์ง๋์ด๋ง ์์คํ ์ ์ฑ ๋ณ๊ฒฝ
=> sentence distance : 31
โ line 37
โ The engineering systems policies (which includes everything under the `/docs/policies` folder within the `azure/azure-sdk` repository) are also proposed via PR and subject to review:
โ ์์ง๋์ด๋ง ์์คํ ์ ์ฑ (azure/azure-sdk ์ ์ฅ์ ๋ด์ /docs/policies ํด๋ ์๋์ ์๋ ๋ชจ๋ ๋ด์ฉ ํฌํจ)๋ PR์ ํตํด ์ ์๋๋ฉฐ ๋ค์ ์ฌํญ์ ๊ฒํ ํ ์ ์์ต๋๋ค.
=> sentence distance : 146
โ line 39
โ PR is reviewed with relevant stake holders, as determined by the engineering systems dev lead (such as service teams, security, and CSS).
โ PR์ ์์ง๋์ด๋ง ์์คํ ๊ฐ๋ฐ ๋ฆฌ๋(์๋น์ค ํ, ๋ณด์, CSS ๋ฑ)์ ์ํด ๊ฒฐ์ ๋๋ ๊ด๋ จ ์ดํด๊ด๊ณ์์ ํจ๊ป ๊ฒํ ๋ฉ๋๋ค.
=> sentence distance : 120
โ line 40
โ PR is approved by the engineering systems dev lead or designate.
โ PR์ ์์ง๋์ด๋ง ์์คํ ๊ฐ๋ฐ ๋ฆฌ๋ ๋๋ ์ง์ ์ ์ํด ์น์ธ๋ฉ๋๋ค.
=> sentence distance : 53
โ line 41
โ If the proposal affects client libraries in a specific language, then the proposal must also be approved by the language dev lead.
โ ์ ์์๊ฐ ํน์ ์ธ์ด์ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ์ํฅ์ ๋ฏธ์น๋ ๊ฒฝ์ฐ ์ ์์๋ ์ธ์ด ๊ฐ๋ฐ ์ฑ ์์์ ์น์ธ์ ๋ฐ์์ผ ํฉ๋๋ค.
=> sentence distance : 115
โ line 43
โ For new language guidelines
โ ์๋ก์ด ์ธ์ด์ ๊ฐ์ด๋๋ผ์ธ
=> sentence distance : 25
โ line 45
โ Language specific guidelines are first published in DRAFT. This means that they are in flux and may be adjusted as the first libraries are created. During the draft phase, there are no requirements on merging
โ ์ธ์ด ๊ณ ์ ์ ๊ฐ์ด๋๋ผ์ธ์ ์ต์ด๋ก ๋๋ํํธ์ ๊ฒ์ฌ๋์ด ์์ต๋๋ค. ์ฆ, ์ด๋ค ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ ์ ๋์ ์ด๋ฉฐ ์ฒซ ๋ฒ์งธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๊ฐ ์์ฑ๋ ๋ ์กฐ์ ๋ ์ ์์ต๋๋ค. ๋๋ํํธ ๋จ๊ณ ์ค์๋
=> sentence distance : 187
โ line 45
โ requests. To move from DRAFT to general availability, the following conditions must be met:
โ request๋ฅผ ๋ณํฉํ๋ ์๊ฑด์ ์์ต๋๋ค. ๋๋ํํธ์์ ์ผ๋ฐ์ผ๋ก ์ดํํ๋ ค๋ฉด ๋ค์ ์กฐ๊ฑด๋ค์ด ์ถฉ์กฑ๋์ด์ผ ํฉ๋๋ค.
=> sentence distance : 76
โ line 47
โ The guidelines are published in draft mode for at least 1 month to allow public comments.
โ ์ด ๊ฐ์ด๋๋ผ์ธ์ ๊ณต๊ฐ ์ฝ๋ฉํธ๋ฅผ ํ์ฉํ๊ธฐ ์ํด ์ต์ 1๊ฐ์ ๋์ ์ด์ ๋ชจ๋๋ก ๊ฒ์๋ฉ๋๋ค.
=> sentence distance : 76
โ line 48
โ The engineering systems are configured for producing client libraries in the language.
โ ์์ง๋์ด๋ง ์์คํ ์ ์ธ์ด๋ก ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ์์ฑํ๋๋ก ๊ตฌ์ฑ๋ฉ๋๋ค.
=> sentence distance : 79
โ line 49
โ and
โ ๋ฐ
=> sentence distance : 3
โ line 49
โ libraries are published in beta to appropriate distribution points.
โ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ ๋ฒ ํ ๋ฒ์ ์ผ๋ก ์ ์ ํ ๋ฐฐํฌ ์ง์ ์ ๊ฒ์๋ฉ๋๋ค.
=> sentence distance : 60
โ line 49
โ The
โ None
=> sentence distance : None
โ line 50
โ At least 2
โ ์ ์ด๋ 2๊ฐ์
=> sentence distance : 10
โ line 50
โ client libraries are published in beta to the appropriate distribution points.
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๊ฐ ์ ์ ํ ๋ฐฐํฌ ์ง์ ์ ๋ฒ ํ ๋ฒ์ ์ผ๋ก ๊ฒ์๋ฉ๋๋ค.
=> sentence distance : 70
โ line 51
โ and
โ ๋ฐ
=> sentence distance : 3
โ line 51
โ library usage (generally as part of a client library user study).
โ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ์ฌ์ฉ(์ฉ๋ก)(์ผ๋ฐ์ ์ผ๋ก ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์ฌ์ฉ์ ์ฐ๊ตฌ์ ์ผ๋ถ)์ ์กฐ์ฌํ๋ ์ฌ์ฉ์ ์ฐ๊ตฌ๊ฐ ์ ์ด๋1๊ฑด ์ค์๋์์ต๋๋ค.
=> sentence distance : 64
โ line 51
โ At least 1 user study has been conducted that studies the
โ None
=> sentence distance : None
โ line 52
โ The guidelines have been reviewed by the architectural board and (if there is one) the language team in DevDiv.
โ ๊ฐ์ด๋๋ผ์ธ์ ์ํคํ ์ฒ ๋ณด๋, ๋ฐ (์กด์ฌํ๋ ๊ฒฝ์ฐ์)DevDiv ์ธ์ด ํ์ด ๊ฒํ ํ์ต๋๋ค.
=> sentence distance : 99
โ line 54
โ None
โ ์ด ์ ์ฑ ๋ณ๊ฒฝ
=> sentence distance : None
โ line 55
โ Changing this policy
โ ์ด ์ ์ฑ ์
=> sentence distance : 19
โ line 57
โ architectural board](mailto:adparch@microsoft.com).
โ ์ํคํ ์ฒ ๋ณด๋](mailto:adparch@microsoft.com)์์๋ง ๋ณ๊ฒฝํ ์ ์์ต๋๋ค.
=> sentence distance : 32
623 words added. 447 words deleted.
Added words rate 124.8496993987976% (623 / 499 words)
Deleted words rate 89.57915831663327% (447 / 499 words)
-
opensource.md : File Modified +752 / -576 ๐ 830
โ line 2
โ "Policies: Open source"
โ "์ ์ฑ : ์คํ ์์ค"
=> sentence distance : 18
โ line 8
โ ensure that all library code is public and open-source on GitHub. Library code must be placed in the
โ ๋ชจ๋ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์ฝ๋๊ฐ GitHub์์ ์คํ ์์ค๋ก ๊ณต๊ฐ๋์ด ์๋์ง ํ์ธํฉ๋๋ค. ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์ฝ๋๋ ์ธ์ด๋ณ ํด๋นํ๋
=> sentence distance : 86
โ line 8
โ 'mono-repo' for its language:
โ '๋จ์ผ ์ ์ฅ์'์ ์์นํด์ผ ํฉ๋๋ค.
=> sentence distance : 26
โ line 18
โ develop in the open on GitHub. Seek feedback from the community on design choices and be active in conversations with the community.
โ GitHub์์ ์คํ๋์ด ์๋ ์ํ์์ ๊ฐ๋ฐ์ ์งํํฉ๋๋ค. ๋์์ธ ์ ํ์ ๋ํ ๋ถ๋ถ์ ์ปค๋ฎค๋ํฐ์์ ํผ๋๋ฐฑ์ ์ฐพ์๋ณด๋ฉฐ, ์ปค๋ฎค๋ํฐ์์๋ ๋ํ์ ์ ๊ทน์ ์ผ๋ก ์ฐธ์ฌํฉ๋๋ค.
=> sentence distance : 114
โ line 20
โ remain active in GitHub. Your client library is your primary touchpoint with the developer community, so it's important to keep up with the activity there. Issues and pull requests on GitHub must have an authoritative comment within one week of filing.
โ GitHub์์ ์ ๊ทน์ ์ผ๋ก ์ํด์ฃผ์ธ์. ์ฌ๋ฌ๋ถ์ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ ๊ฐ๋ฐ์ ์ปค๋ฎค๋ํฐ์์ ์ฃผ๋ ์ ์ ์ด ๋๋ฏ๋ก, ํ๋์ ๊ณ์ ์ด์ด๊ฐ๋ ๊ฒ์ด ์ค์ํฉ๋๋ค. ์ด์์ ํ ๋ฆฌํ์คํธ๋ ์ ์ถ์ด ์ด๋ฃจ์ด์ง๊ณ ๋์ 1์ฃผ์ผ ์ด๋ด์ ์ ๋ขฐํ ์ ์๋ ์ฝ๋ฉํธ๊ฐ ์์ด์ผ ํฉ๋๋ค.
=> sentence distance : 217
โ line 22
โ review the
โ ๊ฑด๊ฐํ ์คํ ์์ค ์ปค๋ฎค๋ํฐ๋ฅผ ์งํฅํ๊ธฐ ์ํ ๋ณด๋ค ์์ธํ ์ ๋ณด์ ๋ํด์๋
=> sentence distance : 38
โ line 22
โ Guidelines' [community section](https://docs.opensource.microsoft.com/releasing/foster-your-community.html) for more information on fostering a healthy open-source community.
โ Guidelines์ ์๋ [์ปค๋ฎค๋ํฐ ์น์ ](https://docs.opensource.microsoft.com/releasing/foster-your-community.html)์ ์ดํด๋ด ๋๋ค.
=> sentence distance : 83
โ line 24
โ CLA](https://cla.opensource.microsoft.com/). Microsoft makes significant contributions to [cla-assistant](https://cla-assistant.io/). It is the easiest way to ensure the CLA is signed by all contributors.
โ CLA](https://cla.opensource.microsoft.com/)๋ฅผ ์ฌ์ฉํฉ๋๋ค. Microsoft์์๋ [cla-assistant](https://cla-assistant.io/)์ ๋ํด ์๋นํ ๊ธฐ์ฌ๋ฅผ ํ๊ณ ์์ต๋๋ค. ์ด๋ ๋ชจ๋ ์ปจํธ๋ฆฌ๋ทฐํฐ๋ค์ด CLA๋ฅผ ์๋ช ํ์๋์ง ํ์ธํ๋ ๊ฐ์ฅ ์ฌ์ด ๋ฐฉ๋ฒ์ ๋๋ค.
=> sentence distance : 99
โ line 24
โ use the
โ None
=> sentence distance : None
โ line 26
โ include a copyright header at the top of every source file (including samples). See the
โ ๋ชจ๋ ์์ค ํ์ผ (์ํ ํฌํจ) ์๋จ์ ์ ์๊ถ(copyright) ํค๋๋ฅผ ํฌํจํฉ๋๋ค. ๋ค์ํ ์ธ์ด์ ๋ํ ํค๋ ์์ ๋ก
=> sentence distance : 76
โ line 26
โ Guidelines](https://docs.opensource.microsoft.com/releasing/copyright-headers.html) for example headers in various languages.
โ Guidelines](https://docs.opensource.microsoft.com/releasing/copyright-headers.html)์ ์ดํด๋ด ๋๋ค.
=> sentence distance : 40
โ line 28
โ The expected copyright header is as follows:
โ ์์๋๋ ์ ์๊ถ ํค๋๋ ๋ค์๊ณผ ๊ฐ์ต๋๋ค:
=> sentence distance : 39
โ line 35
โ content="There is currently disagreement between the
โ content="ํ์ฌ๋
=> sentence distance : 43
โ line 35
โ Guidelines and this advice. This advice is current as of August 2019. Consult CELA if you are unsure as to the proper license."
โ Guideline๊ณผ ํด๋น ์กฐ์ธ์ ์์ด ๋ถ์ผ์น๊ฐ ์์ต๋๋ค. ํด๋น ์กฐ์ธ์ 2019๋ 8์์ ๊ธฐ์ค์ผ๋ก ํฉ๋๋ค. ์ ์ ํ ๋ผ์ด์ ์ค์ ์์ด ๋ถ๋ถ๋ช ํ ์ ์ด ์๋ค๋ฉด CELA์ ์์ํฉ๋๋ค."
=> sentence distance : 98
โ line 39
โ file in your
โ ํ์ผ์
=> sentence distance : 12
โ line 39
โ repository, using it to describe the process by which contributors can make contributions to the project. An example
โ ์ ์ฅ์์ ํฌํจํ์ฌ, ์ปจํธ๋ฆฌ๋ทฐํฐ๋ค์ด ํด๋น ํ๋ก์ ํธ์ ์ปจํธ๋ฆฌ๋ทฐ์ ์ ํ๊ธฐ ์ํ ๊ณผ์ ์ ์ค๋ช ํฉ๋๋ค.
=> sentence distance : 107
โ line 39
โ is provided by the
โ ์์ ๋
=> sentence distance : 18
โ line 39
โ Guidelines](https://docs.opensource.microsoft.com/releasing/overview.html):
โ Guidelines](https://docs.opensource.microsoft.com/releasing/overview.html)์ ๋ฐ๋ผ ์ ๊ณต๋ฉ๋๋ค:
=> sentence distance : 10
โ line 39
โ include a
โ None
=> sentence distance : None
โ line 42
โ Contributing
โ ์ปจํธ๋ฆฌ๋ทฐ์
=> sentence distance : 12
โ line 44
โ This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement
โ ์ด ํ๋ก์ ํธ๋ ์ปจํธ๋ฆฌ๋ทฐ์ ๊ณผ ์ ์์ ํ์ํฉ๋๋ค. ์ปจํธ๋ฆฌ๋ทฐ์ ๋๋ถ๋ถ์ ์ฌ๋ฌ๋ถ์ด ์ปจํธ๋ฆฌ๋ทฐ์ ์ ํ ๊ถ๋ฆฌ๊ฐ ์๊ณ , ์ค์ ๋ก ํ๊ณ ์์ผ๋ฉฐ ์ฌ๋ฌ๋ถ์ ์ปจํธ๋ฆฌ๋ทฐ์ ์ ์ฌ์ฉํ๋ค๋ ๊ถ๋ฆฌ๋ฅผ ์ฐ๋ฆฌ์๊ฒ ๋ณด์ฅํ๋ ์ปจํธ๋ฆฌ๋ทฐํฐ ๋ผ์ด์ธ์ค ์ฝ๊ด
=> sentence distance : 117
โ line 44
โ declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.
โ ๋์๋ฅผ ํ์๋ก ํฉ๋๋ค. ์์ธํ ์ ๋ณด๋ https://cla.microsoft.com ์์ ์ดํด ๋ด ๋๋ค.
=> sentence distance : 124
โ line 46
โ When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a
โ ํ ๋ฆฌํ์คํธ๋ฅผ ์ ์ถํ๋ฉด
=> sentence distance : 98
โ line 46
โ and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repositories using our CLA.
โ ๋ด์ด ์๋์ผ๋ก ์ฌ๋ฌ๋ถ์ด CLA๋ฅผ ์ ๊ณตํ์๋์ง ์ฌ๋ถ๋ฅผ ๊ฒฐ์ ํ๋ฉฐ, PR์ ๋ํด ์ ์ ํ๊ฒ ๊ด๋ฆฌ๋๊ณ ์๋์ง (์: ๋ผ๋ฒจ, ์ฝ๋ฉํธ) ์ฌ๋ถ๋ฅผ ๊ฒฐ์ ํฉ๋๋ค. ๋จ์ํ, ๋ด์ด ์ ๊ณตํ๋ ์๋ด์ ๋ฐ๋ฅด๋ฉด ๋ฉ๋๋ค. ์ ๊ณต๋๋ CLA ์์ ์ ๋ชจ๋ ์ ์ฅ์์ ๊ฑธ์ณ ํ ๋ฒ๋ง ์ํํ๋ฉด ๋ฉ๋๋ค.
=> sentence distance : 156
โ line 48
โ This project has adopted the
โ ์ด ํ๋ก์ ํธ๋
=> sentence distance : 27
โ line 48
โ Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the
โ Conduct](https://opensource.microsoft.com/codeofconduct/)๋ฅผ ์ฑํํ์์ต๋๋ค. ๋ณด๋ค ์์ธํ ์ ๋ณด๋
=> sentence distance : 26
โ line 48
โ FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
โ FAQ](https://opensource.microsoft.com/codeofconduct/faq/)๋ฅผ ์ดํด ๋ณด๊ฑฐ๋ ์ถ๊ฐ์ ์ธ ์ง๋ฌธ ๋๋ ์ฝ๋ฉํธ๊ฐ ์์ ๊ฒฝ์ฐ์๋ [opencode@microsoft.com](mailto:opencode@microsoft.com)๋ก ๋ฌธ์ํด ์ฃผ์ธ์.
=> sentence distance : 70
โ line 53
โ include a
โ ๋ผ์ด์ ์ค ๋ฌธ๊ตฌ(๋ํดํธ๋ก [ํ์ค MIT ๋ผ์ด์ ์ค](https://docs.opensource.microsoft.com/releasing/overview.html#license-files)์ฌ์ผ ํฉ๋๋ค)๋ฅผ ํฌํจํ๋
=> sentence distance : 111
โ line 53
โ file containing your license text (which by default should be the [standard MIT license](https://docs.opensource.microsoft.com/releasing/overview.html#license-files)).
โ ํ์ผ์ ํฌํจํฉ๋๋ค.
=> sentence distance : 165
โ line 57
โ `CODEOWNERS` is a
โ `CODEOWNERS`๋ ๊ฒํ ํ ํ ๋ฆฌํ์คํธ์ ๋ํด ๋๊ฐ ์๋์ผ๋ก ํ ๋น์ด ๋ ์ง๋ฅผ ์ง์ ํ๋
=> sentence distance : 35
โ line 57
โ standard to specify who is automatically assigned pull requests to review. This helps prevent pull requests from languishing without review. GitHub can also be configured to require review from code owners before a pull request can be merged. Further reading is available from the following two URLs:
โ ํ์ค์ ๋๋ค. ์ด๊ฒ์ ํ ๋ฆฌํ์คํธ๊ฐ ๊ฒํ ์์ด ์๋คํด์ง๋ ๊ฒ์ ๋ฐฉ์งํ๋ ๋ฐ ๋์์ ์ค๋๋ค. GitHub๋ ํ ๋ฆฌํ์คํธ๋ฅผ ๋จธ์งํ๊ธฐ ์ ์ ์ฝ๋ ์์ ์์ ๊ฒํ ๋ฅผ ํ์๋ก ํ๋๋ก ๊ตฌ์ฑํ ์๋ ์์ต๋๋ค. ๋ค์ ๋ URL์์ ๋ ์์ธํ ๋ด์ฉ์ ํ์ธํ ์ ์์ต๋๋ค.
=> sentence distance : 260
โ line 62
โ edit the root-level
โ ๋ฃจํธ(root) ๋ ๋ฒจ์ ์๋
=> sentence distance : 17
โ line 62
โ file to ensure that it is updated to redirect all pull requests for the directory of the client library to point to the relevant engineers of this component. If the client library will exist within its own repository, then a
โ ํ์ผ์ ํธ์งํ์ฌ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ๋๋ ํฐ๋ฆฌ์ ๋ํด ์ด ๊ตฌ์ฑ์์์ ๋ํ ์ ์ ํ ์์ง๋์ด๋ฅผ ๊ฐ๋ฆฌํค๋๋ก ๋ชจ๋ ํ ๋ฆฌํ์คํธ์ ๋ํ ๋ฆฌ๋ค์ด๋ ์ ์ด ์ ๋ฐ์ดํธ๋์๋์ง๋ฅผ ํ์ธํฉ๋๋ค. ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๊ฐ ์์ฒด ์ ์ฅ์ ๋ด์ ์กด์ฌํ๋ ๊ฒฝ์ฐ,
=> sentence distance : 197
โ line 62
โ file must be introduced and configured appropriately.
โ ํ์ผ์ ๋์ ํ๊ณ ์ ์ ํ๊ฒ ๊ตฌ์ฑ์ ํด์ผ ํฉ๋๋ค.
=> sentence distance : 47
โ line 64
โ Use the following rules to ensure that we can use CODEOWNERS for both
โ ๋ค์ ๊ท์น์ ์ฌ์ฉํ์ฌ
=> sentence distance : 67
โ line 64
โ and build failure notifications:
โ ๋ฐ ๋น๋ ์คํจ ์๋ฆผ ๋ชจ๋์ CODEOWNERS๋ฅผ ์ฌ์ฉํ ์ ์๋์ง ํ์ธํฉ๋๋ค.
=> sentence distance : 40
โ line 66
โ file
โ ํ์ผ์ ์ฌ์ฉํฉ๋๋ค.
=> sentence distance : 10
โ line 66
โ Use the
โ None
=> sentence distance : None
โ line 67
โ (with the leading and trailing slashes) convention to define service owners
โ (์ฌ๋์ ๊ธฐํธ๋ฅผ ์์๊ณผ ๋ ๋ถ๋ถ์ ํจ๊ป ์ฌ์ฉ) ํต์ฉ ๊ท์น์ ๋ฐ๋ผํ์ฌ ์๋น์ค ์์ ์๋ฅผ ์ ์ํฉ๋๋ค.
=> sentence distance : 64
โ line 67
โ Follow the
โ None
=> sentence distance : None
โ line 68
โ When using this format, service owners will be automatically subscribed to build notification failure alerts
โ ์ด ํฌ๋งท์ ์ฌ์ฉํ๋ ๊ฒฝ์ฐ์๋, ์๋น์ค ์์ ์๋ค์ ์๋์ผ๋ก ๋น๋ ์๋ฆผ ์คํจ ๊ฒฝ๊ณ ๋ฅผ ๊ตฌ๋ ํ๊ฒ ๋ ๊ฒ์ ๋๋ค
=> sentence distance : 94
โ line 69
โ Place more general rules higher in the file and more specific rules lower in the file as GitHub uses the last matching expression
โ GitHub๊ฐ ๋ง์ง๋ง์ ์ผ์นํ๋ ํํ (๊ท์น)์ ์ฌ์ฉํ๋ฏ๋ก, ๋ณด๋ค ์ผ๋ฐ์ ์ธ ๊ท์น์ ํ์ผ ์์ชฝ์ ๋ฐฐ์นํ๊ณ , ๋ณด๋ค ๊ตฌ์ฒด์ ์ธ ๊ท์น์ ํ์ผ ์๋ ๋ถ๋ถ์ ๋ฐฐ์นํฉ๋๋ค.
=> sentence distance : 112
โ line 70
โ Use only GitHub person aliases for the owners (e.g.
โ ์์ ์์ ๋ํด GitHub์์ (์ง์ ํ๋) ์ฌ๋์ ๋ํ ๋ณ์นญ๋ง์ ์ฌ์ฉํฉ๋๋ค (์:
=> sentence distance : 40
โ line 70
โ groups,
โ ๋ด๋ถ ์ฌ์ฉ์, ๋ด๋ถ ๊ทธ๋ฃน ๋ณ์นญ ๋ฐ ์ด๋ฉ์ผ ์ฃผ์์ ์ฐ๊ฒฐ๋์ง ์์-] GitHub [-๊ทธ๋ฃน ๋ฐ
=> sentence distance : 49
โ line 70
โ users that aren't linked to internal users, internal group aliases, and email addresses are not supported at this time.
โ ์ฌ์ฉ์๋ ํ์ฌ ์ง์ํ์ง ์์ต๋๋ค.
=> sentence distance : 115
โ line 70
โ None
โ ๋ด๋ถ ์ฌ์ฉ์, ๋ด๋ถ ๊ทธ๋ฃน ๋ณ์นญ ๋ฐ ์ด๋ฉ์ผ ์ฃผ์์ ์ฐ๊ฒฐ๋์ง ์์
=> sentence distance : None
โ line 71
โ If you want PRs in those folders to be auto-labeled, add a comment line above the entry with the path with the content of
โ ํด๋น ํด๋์ PR์ ์๋ ๋ผ๋ฒจ๋ง์ ์ง์ ํ๊ณ ์ถ๋ค๋ฉด,
=> sentence distance : 112
โ line 71
โ followed by the `%Label` you want to apply. Note: Currently wildcards are not supported and just one label per folder works for now.
โ ๋ค์์ ์ ์ฉํ๋ ค๋ `%Label`์ ๋ด์ฉ์ด ์๋ ๊ฒฝ๋ก์ ํจ๊ป ํญ๋ชฉ ์์ ์ฃผ์ ์ค์ ์ถ๊ฐํด์ผ ํฉ๋๋ค. ์ฐธ๊ณ : ํ์ฌ ์์ผ๋์นด๋๋ ์ง์๋์ง ์์ผ๋ฉฐ, ํด๋๋น ํ๋์ ๋ผ๋ฒจ๋ง ์๋ํฉ๋๋ค.
=> sentence distance : 106
โ line 72
โ You can also capture the information about which people have to be notified when issues are filed for a service. To do that, you have to add the
โ ์๋น์ค์ ๋ํ ์ด์๊ฐ ์ ์๋ ๋ ๋๊ฐ ์๋ฆผ์ ๋ฐ์์ผ ํ๋์ง์ ๋ํ ์ ๋ณด ๋ํ ๊ธฐ๋กํ ์ ์์ต๋๋ค. ์ด๋ฅผ ์ํด์๋,
=> sentence distance : 126
โ line 72
โ followed by the
โ ๋ค์์ ์ด์๋ฅผ ์ ์ฉํด์ผ ํ๋
=> sentence distance : 15
โ line 72
โ that have to be applied to an issue in order for the people specified in the path below to be mentioned by the bot.
โ ์ด ์ค๋๋ก ํ๊ณ , ์๋์๋ ๊ฒฝ๋ก์ ํจ๊ป ์ด์์ ๋ํด ์ง์ ๋ ์ฌ๋๋ค์ด ์ธ๊ธ๋ ์ ์๋๋ก ์ถ๊ฐํด์ผ ํฉ๋๋ค.
=> sentence distance : 100
โ line 73
โ If the code for a service is not inside the repo, you can use this special commented out path to allow issues to be tagged for a service:
โ ์๋น์ค์ ๋ํ ์ฝ๋๊ฐ ์ ์ฅ์ ๋ด์ ์กด์ฌํ์ง ์๋ ๊ฒฝ์ฐ์๋
=> sentence distance : 130
โ line 73
โ None
โ ๋ผ๋ ํน์ํ ์ฃผ์์ ๊ฒฝ๋ก์ ์ฌ์ฉํ์ฌ ์๋น์ค์ ๋ํ ์ด์๋ฅผ ํ์ฉํ๋๋ก ํ ์ ์์ต๋๋ค.
=> sentence distance : None
โ line 74
โ character, you can use spaces. Labels are delimited by the start of the
โ ๋ฌธ์์ ํจ๊ป ๋ผ๋ฒจ์ ์ฌ์ฉํ๋ ๊ฒฝ์ฐ, ๊ณต๋ฐฑ ๋ฌธ์๋ฅผ ์ฌ์ฉํ ์ ์์ต๋๋ค. ๋ผ๋ฒจ์
=> sentence distance : 62
โ line 74
โ character.
โ ๋ฌธ์๋ฅผ ์์์ผ๋ก ํ์ฌ ๊ตฌ๋ถ์ด ์ด๋ฃจ์ด์ง๋๋ค.
=> sentence distance : 22
โ line 74
โ For the labels that are used with the
โ None
=> sentence distance : None
โ line 103
โ This example
โ ์ด
=> sentence distance : 12
โ line 103
โ file has a catch-all list of owners at the top of the file and drills into specific service teams. GitHub uses the *last* matching expression to assign reviewers. For example, a PR with changes in `/sdk/keyvault/` will result in
โ ํ์ผ ์์ ์๋ ํ์ผ ์๋จ ๋ถ๋ถ์ ํฌ๊ด์ ์ธ ์์ ์ ๋ชฉ๋ก์ด ์์ผ๋ฉฐ, ํน์ ์๋น์ค ํ์ ๋ํด ์์ธํ ์ค๋ช ํฉ๋๋ค. GitHub๋ *๋ง์ง๋ง์* ์ผ์นํ๋ ํํ์์ ์ฌ์ฉํ์ฌ ๋ฆฌ๋ทฐ์ด๋ฅผ ํ ๋นํฉ๋๋ค. ์๋ฅผ ๋ค์ด `/sdk/keyvault/`๊ฐ ๋ณ๊ฒฝ๋ PR์
=> sentence distance : 178
โ line 103
โ and `@person6` being added to the PR. If a new service, like batch, were added with changes under
โ ๋ฐ `@person6`์ด PR์ ์ถ๊ฐ๋ฉ๋๋ค. ๋ฐฐ์น์ ๊ฐ์ ์๋ก์ด ์๋น์ค๊ฐ
=> sentence distance : 78
โ line 103
โ then
โ ์๋์ ๋ณ๊ฒฝ ์ฌํญ์ผ๋ก ์ถ๊ฐ๋ ๊ฒฝ์ฐ
=> sentence distance : 18
โ line 103
โ and `@person2` will be assigned.
โ ๋ฐ `@person2`๊ฐ ํ ๋น๋ฉ๋๋ค.
=> sentence distance : 19
752 words added. 576 words deleted.
Added words rate 90.60240963855422% (752 / 830 words)
Deleted words rate 69.39759036144578% (576 / 830 words)
-
pipelines.md : File Modified +273 / -191 ๐ 208
โ line 2
โ "Policies: Pipelines"
โ "์ ์ฑ : ํ์ดํ๋ผ์ธ"
=> sentence distance : 17
โ line 8
โ SDK is considered a unified set of libraries, each group of libraries ships on a separate cadence with varying levels of change as dictated by the needs of the service that those libraries support.
โ SDK๋ ํตํฉ๋ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ์งํฉ์ผ๋ก ์ฌ๊ธฐ์ง๋ง, ๊ฐ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ๊ทธ๋ฃน์ ํด๋น ๋ผ์ด๋ธ๋ฌ๋ฆฌ๊ฐ ์ง์ํ๋ ์๋น์ค์ ์๊ตฌ ์ฌํญ์ ๋ฐ๋ผ ๋ณ๋์ ์ฃผ๊ธฐ๋ก ๋ค์ํ ์์ค์ ๋ณ๊ฒฝ๊ณผ ํจ๊ป ์ ๊ณต๋ฉ๋๋ค.
=> sentence distance : 171
โ line 10
โ Pipeline per "Service"
โ "์๋น์ค"๋ณ ํ์ดํ๋ผ์ธ
=> sentence distance : 21
โ line 12
โ Our pipelines are derived by the way that we ship our libraries to customers. For example we would generally expect to ship some or all of the storage libraries together, so there is a set of pipelines for
โ ํ์ดํ๋ผ์ธ์ ์ฐ๋ฆฌ๊ฐ ๊ณ ๊ฐ์๊ฒ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ๋ณด๋ด๋ ๋ฐฉ์์ ์ํด ํ์๋ฉ๋๋ค. ์๋ฅผ ๋ค์ด, ์ผ๋ฐ์ ์ผ๋ก ์คํ ๋ฆฌ์ง ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ์ผ๋ถ ๋๋ ์ ์ฒด๋ฅผ ํจ๊ป ๋ณด๋ด๋ ๊ฒ์ ์์ํ๋ฏ๋ก,
=> sentence distance : 184
โ line 12
โ validation,
โ ์ ํจ์ฑ ๊ฒ์ฌ,
=> sentence distance : 10
โ line 12
โ and release which operate on code located in the ```sdk/storage/``` path within the repo.
โ ๋ฐ ๋ฐฐํฌ๋ฅผ ์ํ ์ผ๋ จ์ ํ์ดํ๋ผ์ธ์ด repo ๋ด์```sdk/storage/``` ๊ฒฝ๋ก์ ์๋ ์ฝ๋์์ ์๋ํฉ๋๋ค.
=> sentence distance : 61
โ line 14
โ This means that for each language/runtime mono-repo we have multiple pipelines, with each pipeline focused on building and releasing those packages. The entry point to each pipeline is located at ```sdk/[service]/ci.yml``` which defines any custom variables and selects appropriate templates for that pipeline.
โ ์ด๋ ๊ฐ ์ธ์ด/๋ฐํ์ ๋ชจ๋ ธ-๋ฆฌํฌ(mono-repo)์ ๋ํด ์ฌ๋ฌ ํ์ดํ๋ผ์ธ์ด ์์์ ์๋ฏธํ๋ฉฐ, ๊ฐ ํ์ดํ๋ผ์ธ์ ํด๋น ํจํค์ง๋ฅผ ๊ตฌ์ถํ๊ณ ๋ฐฐํฌํ๋๋ฐ ์ค์ ์ ๋ก๋๋ค. ๊ฐ ํ์ดํ๋ผ์ธ์ ์ง์ ์ ์ ```sdk/[service]/ci.yml```์ ์์ผ๋ฉฐ, ์ด๊ณณ์์ ๋ชจ๋ ์ฌ์ฉ์ ์ง์ ๋ณ์๋ฅผ ์ ์ํ๊ณ ํด๋น ํ์ดํ๋ผ์ธ์ ์ ํฉํ ํ ํ๋ฆฟ์ ์ ํํฉ๋๋ค.
=> sentence distance : 243
โ line 16
โ Creation of the pipeline within
โ ํ์ดํ๋ผ์ธ์
=> sentence distance : 31
โ line 16
โ Pipelines is automated. When a
โ ํ์ดํ๋ผ์ธ ๋ด์์ ์๋์ผ๋ก ์์ฑ๋ฉ๋๋ค.
=> sentence distance : 28
โ line 16
โ file is added to the repository, an automated process runs (every hour, unless manually triggered) which creates a public and internal pipeline.
โ ํ์ผ์ด ์ ์ฅ์์ ์ถ๊ฐ๋๋ฉด, ์๋ํ๋ ํ๋ก์ธ์ค๊ฐ ์คํ๋์ด(์๋์ผ๋ก ํธ๋ฆฌ๊ฑฐ๊ฐ ๋์ง ์๋ ํ, ๋งค์๊ฐ) ๊ณต์ฉ ๋ฐ ๋ด๋ถ ํ์ดํ๋ผ์ธ์ด ์์ฑ๋ฉ๋๋ค.
=> sentence distance : 126
โ line 18
โ Pipeline Optimization and Special Case Pipelines
โ ํ์ดํ๋ผ์ธ ์ต์ ํ ๋ฐ ํน์ ์ฌ๋ก ํ์ดํ๋ผ์ธ
=> sentence distance : 43
โ line 20
โ In general each pipeline that ships a library (or set of libraries) to customers should be optimized to perform necessary build, test and static analysis steps for just that set of libraries. Where it is desirable to run analysis across the entire repository, these tasks should be pulled out into special case pipelines.
โ ์ผ๋ฐ์ ์ผ๋ก ๊ณ ๊ฐ์๊ฒ ๋ผ์ด๋ธ๋ฌ๋ฆฌ(๋๋ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์งํฉ)๋ฅผ ์ ๊ณตํ๋ ๊ฐ ํ์ดํ๋ผ์ธ์ ํด๋น ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์งํฉ์ ๋ํด ํ์ํ ๋น๋, ํ ์คํธ ๋ฐ ์ ์ ๋ถ์ ๋จ๊ณ๋ฅผ ์ํํ ์ ์๋๋ก ์ต์ ํ๋์ด์ผ ํฉ๋๋ค. ์ ์ฒด ์ ์ฅ์์ ๋ํ ๋ถ์์ ์คํํ๋ ๊ฒ์ด ๋ฐ๋์งํ ๊ฒฝ์ฐ๋ผ๋ฉด, ํด๋น ์์ ์ ํน์ํ ์ฌ๋ก์ธ ํ์ดํ๋ผ์ธ์ผ๋ก ๋์ด๋ด์ผ ํฉ๋๋ค.
=> sentence distance : 279
โ line 22
โ The reason for this is that we don't want a static analysis failure in one part of the code base blocking the release of an unrelated library. Additionally,
โ ๊ทธ ์ด์ ๋ ์ ์ฒด ์์ค ์ฝ๋์ ํ ๋ถ๋ถ์์ ์ ์ ๋ถ์ ์ค๋ฅ๊ฐ ๋ฐ์ํ์ฌ ๊ด๋ จ ์๋ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ๋ฐฐํฌ๊ฐ ์ฐจ๋จ๋๋ ๊ฒ์ ์ํ์ง ์๊ธฐ ๋๋ฌธ์ ๋๋ค. ๋ํ,
=> sentence distance : 134
โ line 22
โ analysis steps generally take a long time and it is inappropriate to bog down the pipelines for this activity.
โ ๋ถ์ ๋จ๊ณ์์๋ ์ผ๋ฐ์ ์ผ๋ก ์๊ฐ์ด ์ค๋ ๊ฑธ๋ฆฌ๊ณ ์ด๋ฅผ ์ํด ํ์ดํ๋ผ์ธ์ ์ค๋จ์ํค๋ ๊ฒ์ ๋ถ์ ์ ํฉ๋๋ค.
=> sentence distance : 98
273 words added. 191 words deleted.
Added words rate 131.25% (273 / 208 words)
Deleted words rate 91.82692307692307% (191 / 208 words)
-
releasenotes.md : File Modified +890 / -635 ๐ 692
โ line 2
โ "Policies: Release Notes"
โ "์ ์ฑ : ๋ฆด๋ฆฌ์ค ๋ ธํธ"
=> sentence distance : 20
โ line 8
โ Producing Release Notes
โ ๋ฆด๋ฆฌ์ค ๋ ธํธ ์์ฑํ๊ธฐ
=> sentence distance : 21
โ line 10
โ Each release cycle, we produce release notes for every language. This process is partly automated. Our automation runs regularly and produces pull requests with titles of the form **({Language} release notes for the {YYYY-MM} release)** for
โ ๊ฐ ๋ฆด๋ฆฌ์ค ์ฌ์ดํด๋ง๋ค ๋ชจ๋ ์ธ์ด์ ๋ํ ๋ฆด๋ฆฌ์ฆ ๋ ธํธ๋ฅผ ์์ฑํฉ๋๋ค. ์ด ๊ณผ์ ์ ๋ถ๋ถ์ ์ผ๋ก ์๋ํ๋์ด ์์ต๋๋ค. ์๋ํ ์์คํ ์ ์ ๊ธฐ์ ์ผ๋ก ์คํ๋๋ฉฐ
=> sentence distance : 222
โ line 10
โ js, and python. Below are instructions for updating/reviewing the PRs before merging.
โ js ๋ฐ python์ ๋ํด **({YYYY-MM} ๋ฆด๋ฆฌ์ค์ ๋ํ {Language} ๋ฆด๋ฆฌ์ฆ ๋ ธํธ)** ํ์์ ์ ๋ชฉ์ผ๋ก pull requests๋ฅผ ์์ฑํฉ๋๋ค. ๋ค์์ ๋ณํฉํ๊ธฐ ์ ์ PR์ ์ ๋ฐ์ดํธ/๊ฒํ ํ๊ธฐ ์ํ ์ง์นจ์ ๋๋ค.
=> sentence distance : 101
โ line 12
โ The **engineering leads** for the released packages should make sure they have been picked up by the automation and that the entry is correct.
โ ๋ฆด๋ฆฌ์ค๋ ํจํค์ง์ **์์ง๋์ด๋ง ๋ฆฌ๋**๋ ์๋ํ ์์คํ ์ ์ํด ์ ์ธ์๋๊ณ ์๋์ง, ์ํธ๋ฆฌ๊ฐ ์ฌ๋ฐ๋ฅธ์ง ํ์ธํด์ผ ํฉ๋๋ค.
=> sentence distance : 127
โ line 13
โ You can update the generated data at `_data/releases/YYYY-MM/{language}.yml` by adding
โ `_data/releases/YYYY-MM/{language}.yml`์ ์์ฑ๋ ๋ฐ์ดํฐ๋ฅผ ์ ๋ฐ์ดํธํ๋ ค๋ฉด, ๊ฒํ ์ ๋ฆด๋ฆฌ์ค ๋๋ผ์ด๋ธ๊ฐ PR์ ์ปค๋ฐํ ์ ์๋
=> sentence distance : 81
โ line 13
โ style suggestions to the PR that the release driver can commit to the PR when reviewed.
โ ์คํ์ผ์ ์ ์์ ์ถ๊ฐํด์ผ ํฉ๋๋ค.
=> sentence distance : 83
โ line 14
โ Suggest new release entries that should be added to the PR if it has not already been added by the automation (it most likely will be).
โ ์๋ํ ์์คํ ์ ์ํด ์์ง ์ถ๊ฐ๋์ง ์์ ๊ฒฝ์ฐ, PR์ ์ถ๊ฐํด์ผ ํ ์๋ก์ด ๋ฆด๋ฆฌ์ค ์ํธ๋ฆฌ๋ฅผ ์ ์ํฉ๋๋ค.(๋๋ถ๋ถ์ ๊ฒฝ์ฐ)
=> sentence distance : 117
โ line 15
โ If there are packages that should be in the release that don't appear it is probably because the automation has not run since the package was released. Your package should generally get picked up by the automation within 24 hours.
โ ๋ฆด๋ฆฌ์ค์ ์์ด์ผ ํ ํจํค์ง๊ฐ ํ์๋์ง ์๋ ๊ฒฝ์ฐ, ํจํค์ง๊ฐ ๋ฆด๋ฆฌ์ค๋ ํ ์๋ํ๊ฐ ์คํ๋์ง ์์๊ธฐ ๋๋ฌธ์ผ ์ ์์ต๋๋ค. ํจํค์ง๋ ์ผ๋ฐ์ ์ผ๋ก ๋ณดํต 24์๊ฐ ์ด๋ด์ ์๋ํ ์์คํ ์ ์ํด ์ธ์๋์ด์ผ ํฉ๋๋ค.
=> sentence distance : 203
โ line 16
โ The generated data in `_data/releases/YYYY-MM/{language}.yml` is pulled into the proper sections in the corresponding markdown file at `releases/YYYY-MM/{language}.md` by the
โ `_data/releases/YYYY-MM/{language}.yml`์์ ์์ฑ๋ ๋ฐ์ดํฐ๋
=> sentence distance : 133
โ line 16
โ engine. Once changes to the
โ ์์ง์ ์ํด `releases/YYYY-MM/{language}.md`์ ์๋ ํด๋น Markdown ํ์ผ์ ํด๋น ์น์ ์ผ๋ก ๊ฐ์ ธ์ต๋๋ค.
=> sentence distance : 64
โ line 16
โ file is merged into main you can see the content pulled into the
โ ํ์ผ์ ๋ณ๊ฒฝ ๋ด์ฉ์ด ๋ฉ์ธ ํ์ผ์ ๋จธ์ง๋๋ฉด
=> sentence distance : 59
โ line 16
โ site at `https://azure.github.io/azure-sdk/releases/YYYY-MM/{language}.html`
โ ์ฌ์ดํธ `https://azure.github.io/azure-sdk/releases/YYYY-MM/{language}.html`์์ ๊ฐ์ ธ์จ ๋ด์ฉ์ ๋ณผ ์ ์์ต๋๋ค.
=> sentence distance : 27
โ line 18
โ The **release manager** should hide all entries for packages that should not be in the release period, review and merge the pull request.
โ **๋ฆด๋ฆฌ์ค ๊ด๋ฆฌ์**๋ ๋ฆด๋ฆฌ์ค ๊ธฐ๊ฐ์ ์์ด์๋ ์ ๋๋ ํจํค์ง์ ๋ชจ๋ ์ํธ๋ฆฌ๋ฅผ ์จ๊ธฐ๊ณ , full request๋ฅผ ๊ฒํ ํ๊ณ ๋จธ์งํด์ผ ํฉ๋๋ค.
=> sentence distance : 113
โ line 19
โ field to `true`.
โ ํ๋๋ฅผ `true`๋ก ์ค์ ํ๋ฉด ์ํธ๋ฆฌ๋ฅผ ์จ๊ธธ ์ ์์ต๋๋ค.
=> sentence distance : 28
โ line 20
โ After code complete, the release manager will do a final editorial pass before linking the release notes into the table of contents.
โ ์ฝ๋๊ฐ ์๋ฃ๋ ํ, ๋ฆด๋ฆฌ์ค ๊ด๋ฆฌ์๋ ๋ฆด๋ฆฌ์ค ๋ ธํธ๋ฅผ ๋ชฉ์ฐจ์ ์ฐ๊ฒฐํ๊ธฐ ์ ์ ์ต์ข ํธ์ง ๋จ๊ณ๋ฅผ ์ํํฉ๋๋ค.
=> sentence distance : 117
โ line 22
โ Release notes are part of the release and must be ready for final edit by the "Code Complete" date.
โ ๋ฆด๋ฆฌ์ค ๋ ธํธ๋ ๋ฆด๋ฆฌ์ค์ ์ผ๋ถ์ด๋ฉฐ "์ฝ๋ ์๋ฃ" ๋ ์ง๊น์ง ์ต์ข ํธ์งํ ์ค๋น๊ฐ ๋์ด ์์ด์ผ ํฉ๋๋ค.
=> sentence distance : 86
โ line 24
โ What's in a release note?
โ ๋ฆด๋ฆฌ์ค ๋ ธํธ์๋ ๋ฌด์์ด ์์ต๋๊น?
=> sentence distance : 21
โ line 26
โ The release notes consist of four sections:
โ ๋ฆด๋ฆฌ์ค ๋ ธํธ๋ ๋ค์ 4๊ฐ์ ์์ ์ผ๋ก ๊ตฌ์ฑ๋์ด ์์ต๋๋ค:
=> sentence distance : 37
โ line 28
โ A list of packages that are being released (that have developer impacting changes) and how to install the packages.
โ ๋ฆด๋ฆฌ์ค ์ค์ธ ํจํค์ง ๋ชฉ๋ก(๋ณ๊ฒฝ ์ฌํญ์ ์ํฅ์ ๋ฏธ์น๋ ๊ฐ๋ฐ์๊ฐ ์๋) ๋ฐ ํจํค์ง ์ค์น ๋ฐฉ๋ฒ
=> sentence distance : 102
โ line 29
โ A list of "developer impacting changes" to each package, organized by package.
โ ํจํค์ง๋ณ๋ก ๊ตฌ์ฑ๋, ๊ฐ ํจํค์ง์ "๋ณ๊ฒฝ ์ฌํญ์ ์ํฅ์ ๋ฏธ์น๋ ๊ฐ๋ฐ์" ๋ชฉ๋ก
=> sentence distance : 70
โ line 30
โ Boilerplate text that provides a link to the latest release information.
โ ์ต์ ๋ฆด๋ฆฌ์ค ์ ๋ณด์ ๋ํ ๋งํฌ๋ฅผ ์ ๊ณตํ๋ ์์ฉ๊ตฌ
=> sentence distance : 66
โ line 31
โ package download, source code, and reference documentation.
โ ํจํค์ง ๋ค์ด๋ก๋, ์์ค ์ฝ๋ ๋ฐ ์ฐธ์กฐ ๋ฌธ์๋ฅผ ๊ฐ๋ฆฌํค๋ ๋งํฌ ํ ์ด๋ธ
=> sentence distance : 52
โ line 31
โ A table of links that point to the
โ None
=> sentence distance : None
โ line 33
โ **Note**: Do not include other documentation or samples in the table of links. These can be accessed via the standard latest release link.
โ **์ฐธ๊ณ **: ๋งํฌ ํ ์ด๋ธ์ ๋ค๋ฅธ ๋ฌธ์๋ ์ํ์ ํฌํจํ์ง ๋ง์ญ์์ค. ํ์ค ์ต์ ๋ฆด๋ฆฌ์ค ๋งํฌ๋ฅผ ํตํด ์ ๊ทผํ ์ ์์ต๋๋ค.
=> sentence distance : 116
โ line 35
โ What's a "developer impacting change"?
โ "๋ณ๊ฒฝ ์ฌํญ์ ์ํฅ์ ๋ฏธ์น๋ ๊ฐ๋ฐ์"๋ ๋ฌด์์ ๋๊น?
=> sentence distance : 34
โ line 37
โ We don't want to advertise every single bug fix as most of them do not impact the way customers think about developing the client. The [change log](https://azure.github.io/azure-sdk/policies_releases.html#change-logs) provides an exhaustive list of changes. We don't need to duplicate it.
โ ๋๋ถ๋ถ์ ๋ฒ๊ทธ ์์ ์ ๊ณ ๊ฐ์ ํด๋ผ์ด์ธํธ ๊ฐ๋ฐ ๋ฐฉ์์ ์ํฅ์ ๋ฏธ์น์ง ์์ผ๋ฏ๋ก ๋ชจ๋ ๋ฒ๊ทธ ์์ ์ฌํญ์ ์๋ฆฌ๊ณ ์ถ์ง๋ ์์ต๋๋ค. [๋ณ๊ฒฝ ๋ก๊ทธ](https://azure.github.io/azure-sdk/policies_releases.html#change-logs)์๋ ์ ์ฒด ๋ณ๊ฒฝ ๋ชฉ๋ก์ ์ ๊ณตํฉ๋๋ค. ๋ณต์ ํ ํ์๊ฐ ์์ต๋๋ค.
=> sentence distance : 190
โ line 39
โ However, in the release notes we do want to list critical changes for customers. A critical change is one that the developer would either need to know or want to know. Use the following section headers (`Features Added`, `Breaking Changes`, and `Bugs Fixed`) for the defined critical changes:
โ ๊ทธ๋ฌ๋ ๋ฆด๋ฆฌ์ค ๋ ธํธ์๋ ๊ณ ๊ฐ์ ์ํ ์ค์ํ ๋ณ๊ฒฝ ์ฌํญ์ด ๋์ด๋์ด ์์ต๋๋ค. ์ค์ํ ๋ณ๊ฒฝ ์ฌํญ์ด๋ ๊ฐ๋ฐ์๊ฐ ์์์ผ ํ๊ฑฐ๋ ์๊ณ ์ถ์ดํ๋ ๊ฒ์ ๋๋ค. ์ ์๋ ์ค์ํ ๋ณ๊ฒฝ ์ฌํญ์๋ ๋ค์ ์น์ ํค๋(`๊ธฐ๋ฅ ์ถ๊ฐ`, `์ฃผ์ ๋ณ๊ฒฝ ์ฌํญ` ๋ฐ `๋ฒ๊ทธ ์์ `)๋ฅผ ์ฌ์ฉํฉ๋๋ค:
=> sentence distance : 249
โ line 41
โ *Features Added*
โ *๊ธฐ๋ฅ ์ถ๊ฐ*
=> sentence distance : 13
โ line 41
โ For new features to be called out in release notes.
โ ๋ฆด๋ฆฌ์ค ๋ ธํธ์ ์ ๊ธฐ๋ฅ์ด ํธ์ถ๋ฉ๋๋ค.
=> sentence distance : 46
โ line 42
โ *Breaking Changes*
โ *์ฃผ์ ๋ณ๊ฒฝ ์ฌํญ*
=> sentence distance : 15
โ line 42
โ For any changes that the will break the customer in some way, such as breaking existing functionality, soon-to-be removed features, or now removed features.
โ ๊ธฐ์กด ๊ธฐ๋ฅ ์ค๋จ, ๊ณง ์ ๊ฑฐ๋ ๊ธฐ๋ฅ ๋๋ ํ์ฌ ์ ๊ฑฐ๋๋ ๊ธฐ๋ฅ ๋ฑ ์ด๋ค ํํ๋ก๋ ๊ณ ๊ฐ์๊ฒ ๋ฌธ์ ๊ฐ ๋๋ ๋ชจ๋ ๋ณ๊ฒฝ์ฌํญ์ ๋๋ค.
=> sentence distance : 138
โ line 43
โ *Bugs Fixed*
โ *๋ฒ๊ทธ ์์ *
=> sentence distance : 9
โ line 43
โ For important bug fixes to be called out in release notes, including any security fixes. Include things that the customer would likely notice or need to react to in some way.
โ ์ค์ํ ๋ฒ๊ทธ ์์ ์ ๋ณด์ ์์ ์ ํฌํจํ์ฌ ๋ฆด๋ฆฌ์ค ๋ ธํธ์ ๊ธฐ์ฌ๋์ด ์์ต๋๋ค. ๊ณ ๊ฐ์ด ์ธ์งํ๊ฑฐ๋ ์ด๋ค ์์ผ๋ก๋ ๋์ํด์ผ ํ๋ ์ฌํญ์ ํฌํจํฉ๋๋ค.
=> sentence distance : 155
โ line 45
โ For example, "The name of the property displayed in the ArgumentOutOfRangeException in the
โ ์๋ฅผ ๋ค์ด, "์ฌ๋ฐ๋ฅธ ์์ฑ ์ด๋ฆ์ ์ฌ์ฉํ๋๋ก SubscriptionProperties์
=> sentence distance : 76
โ line 45
โ property in SubscriptionProperties was updated to use the correct property name." does not qualify as an important bug fix so shouldn't be listed under `Bugs Fixed` but can be listed under `Other Changes`. However, "Added a new overload to the constructor to support AzureAD credentials" would be a good thing to include under `Features Added`.
โ ์์ฑ์ ArgumentOutOfRangeException์ ํ์๋ ์์ฑ ์ด๋ฆ์ด ์ ๋ฐ์ดํธ๋์์ต๋๋ค."๋ ์ค์ํ ๋ฒ๊ทธ ์์ ์ผ๋ก ๊ฐ์ฃผ๋์ง ์์ผ๋ฏ๋ก `๋ฒ๊ทธ ์์ `์๋์ ๋์ดํด์๋ ์ ๋์ง๋ง `๋ค๋ฅธ ์์ ์ฌํญ`์๋ ๋์ดํ ์ ์์ต๋๋ค. ๊ทธ๋ฌ๋, "AzureAD ์๊ฒฉ ์ฆ๋ช ์ ์ง์ํ๊ธฐ ์ํด ์์ฑ์์ ์๋ก์ด ๊ณผ๋ถํ๋ฅผ ์ถ๊ฐํ์ต๋๋ค"๋ `๊ธฐ๋ฅ ์ถ๊ฐ`์๋์ ๊ธฐ์ฌํ๋ ๊ฒ์ด ์ข์ต๋๋ค.
=> sentence distance : 292
โ line 47
โ Ensure the release notes are written from the perspective of the user. We don't want to tell them about a new change without ALSO telling them how to take advantage of the change with either a link to the documentation or a short snippet of code.
โ ๋ฆด๋ฆฌ์ค ๋ ธํธ๊ฐ ์ฌ์ฉ์์ ๊ด์ ์์ ์์ฑ๋์๋์ง ํ์ธํฉ๋๋ค. ๋ฌธ์ ๋งํฌ๋ ์งง์ ์ฝ๋ ์กฐ๊ฐ์ผ๋ก ๋ณ๊ฒฝ ์ฌํญ์ ํ์ฉํ๋ ๋ฐฉ๋ฒ์ ์ค๋ช ํ์ง ์๊ณ ์ ์๋ก์ด ๋ณ๊ฒฝ์ฌํญ์ ๋ํด ์๋ ค์ฃผ๊ณ ์ถ์ง ์์ต๋๋ค.
=> sentence distance : 224
โ line 49
โ What if my library is changed but doesn't have any "developer impacting changes"?
โ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๊ฐ ๋ณ๊ฒฝ๋์์ง๋ง "๋ณ๊ฒฝ ์ฌํญ์ ์ํฅ์ ์ฃผ๋ ๊ฐ๋ฐ์"๊ฐ ์์ผ๋ฉด ์ด๋ป๊ฒ ํฉ๋๊น?
=> sentence distance : 71
โ line 51
โ You can either leave the library out of the release notes, or add a note such as "This release contains bug fixes to improve quality."
โ ๋ฆด๋ฆฌ์ค ๋ ธํธ์์ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ์ ์ธํ๊ฑฐ๋ "์ด ๋ฆด๋ฆฌ์ค์๋ ํ์ง์ ํฅ์์ํค๊ธฐ ์ํ ๋ฒ๊ทธ ์์ ์ด ํฌํจ๋์ด ์์ต๋๋ค"์ ๊ฐ์ ๋ฉ๋ชจ๋ฅผ ์ถ๊ฐํ ์ ์์ต๋๋ค.
=> sentence distance : 116
โ line 53
โ How to produce quick links?
โ ๋น ๋ฅธ ๋งํฌ๋ฅผ ์์ฑํ๋ ๋ฐฉ๋ฒ์ ๋ฌด์์ ๋๊น?
=> sentence distance : 23
โ line 55
โ The release manager will produce the point-in-time snapshot of the versions and ensure the release notes use the snapshot to generate the quick links tables.
โ ๋ฆด๋ฆฌ์ค ๊ด๋ฆฌ์๋ ๋ฒ์ ์ ํน์ ์์ ์ค๋ ์ท์ ์์ฑํ๊ณ ๋ฆด๋ฆฌ์ค ๋ ธํธ๊ฐ ์ค๋ ์ท์ ์ฌ์ฉํ์ฌ ๋น ๋ฅธ ๋งํฌ ํ ์ด๋ธ์ ์์ฑํ๋๋ก ํฉ๋๋ค.
=> sentence distance : 141
โ line 57
โ Who publishes the release notes and when are they published?
โ ๋ฆด๋ฆฌ์ค ๋ ธํธ๋ ๋๊ฐ, ์ธ์ ๊ฒ์ํฉ๋๊น?
=> sentence distance : 55
โ line 59
โ For all releases, the release manager will merge and publish the release notes in the current month's release folder.
โ ๋ชจ๋ ๋ฆด๋ฆฌ์ค์ ๋ํด, ๋ฆด๋ฆฌ์ค ๊ด๋ฆฌ์๋ ์ด ๋ฌ์ ๋ฆด๋ฆฌ์ค ํด๋์ ๋ฆด๋ฆฌ์ฆ ๋ ธํธ๋ฅผ ๋ณํฉํ์ฌ ๊ฒ์ํฉ๋๋ค.
=> sentence distance : 104
โ line 61
โ What do I need to do for an out-of-band release?
โ ๋์ญ ์ธ ๋ฆด๋ฆฌ์ค์์๋ ์ด๋ป๊ฒ ํด์ผ ํฉ๋๊น?
=> sentence distance : 42
โ line 63
โ If you need to release a library after the official release notes release date has occurred but before the next month has been released, then add your release notes to the current month's release notes. The
โ ๊ณต์ ๋ฆด๋ฆฌ์ค ๋ ธํธ ์ถ์์ผ ์ดํ ๋ค์ ์ถ์์ผ ์ ์ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ์ถ์ํด์ผ ํ๋ ๊ฒฝ์ฐ, ๋ค์ ๋ฆด๋ฆฌ์ค ๋ ธํธ๋ฅผ ์ด๋ฒ ๋ฌ ๋ฆด๋ฆฌ์ค ๋ ธํธ์ ์ถ๊ฐํ์ญ์์ค.
=> sentence distance : 185
โ line 63
โ Owner_ will merge and publish the release notes in the current month's release folder.
โ Owner_๋ ์ด๋ฒ ๋ฌ์ ๋ฆด๋ฆฌ์ค ํด๋์ ๋ฆด๋ฆฌ์ค ๋ ธํธ๋ฅผ ๋ณํฉํ์ฌ ๊ฒ์ํฉ๋๋ค.
=> sentence distance : 71
โ line 70
โ None
โ ์๋ฅผ ๋ค์ด:
=> sentence distance : None
โ line 71
โ None
โ 1. ๊ณต์ ๋ฆด๋ฆฌ์ค ๋ ธํธ๋ 2020๋ 9์ 18์ผ์ ๋ฐํ๋ฉ๋๋ค.
=> sentence distance : None
โ line 72
โ None
โ 1. ์ถํ๋์ด์ผ ํ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ 2020๋ 9์ 22์ผ๊น์ง ์ถํ๋์ง ์์ต๋๋ค.
=> sentence distance : None
โ line 73
โ If you have any questions, please reach out to your team's
โ 1. PR์ ์ ์ถํ์ฌ 9์ ๋ฆด๋ฆฌ์ค ๋ ธํธ์ ๋ฆด๋ฆฌ์ค ๋ ธํธ๋ฅผ ์ถ๊ฐํ๊ณ
=> sentence distance : 50
โ line 73
โ Owner_.
โ Owner_์ ํ๊ทธ๋ฅผ ๋ถ์ ๋๋ค.
=> sentence distance : 10
โ line 75
โ You may optionally provide social media outreach for out-of-band releases. Contact the _Community Engagement Manager_ for details on this at least 7 working days prior to the release.
โ ์ง๋ฌธ์ด ์๋ ๊ฒฝ์ฐ, ํ์ _Language Release Owner_์๊ฒ ๋ฌธ์ํ์ญ์์ค.
=> sentence distance : 162
โ line 77
โ ## Where do I go if I need help?
โ ํ์์ ๋ฐ๋ผ ๋์ญ ์ธ ๋ฆด๋ฆฌ์ค์ ์์ ๋ฏธ๋์ด ์ง์์ ์ ํ์ ์ผ๋ก ์ ๊ณตํ ์ ์์ต๋๋ค. ์์ธํ ๋ด์ฉ์ ์ถ์ ์ต์ 7์ผ(์์ ์ผ ๊ธฐ์ค) ์ ์ _์ปค๋ฎค๋ํฐ ์ฐธ์ฌ ๊ด๋ฆฌ์_์๊ฒ ๋ฌธ์ ํ์ญ์์ค.
=> sentence distance : 90
โ line 79
โ None
โ ## ๋์์ด ํ์ํ๋ฉด ์ด๋์ ์์ฒญํด์ผ ํฉ๋๊น?
=> sentence distance : None
โ line 81
โ The
โ ๋ฆด๋ฆฌ์ฆ์ ๋ํ ๋์์ด ํ์ํ ๋
=> sentence distance : 17
โ line 81
โ release manager_ is best place to start when you need help with a release. They manage the Release channel in the
โ ๋ฆด๋ฆฌ์ค ๊ด๋ฆฌ์_๊ฐ ๊ฐ์ฅ ์ ํฉํฉ๋๋ค.
=> sentence distance : 108
โ line 81
โ team. If you need help you can post a message in that Teams channel here:
โ ํ์์ Release ์ฑ๋์ ๊ด๋ฆฌํฉ๋๋ค. ๋์์ด ํ์ํ ๊ฒฝ์ฐ ๋ค์ URL์ ํ ์ฑ๋์ ๋ฉ์์ง๋ฅผ ๊ฒ์ํ ์ ์์ต๋๋ค:
=> sentence distance : 62
890 words added. 635 words deleted.
Added words rate 128.61271676300578% (890 / 692 words)
Deleted words rate 91.76300578034682% (635 / 692 words)
-
releases.md : File Modified +293 / -127 ๐ 4462
โ line 72
โ Follow the best practices below to ensure that the visibility of the new release is elevated.
โ When
=> sentence distance : 90
โ line 74
โ as early as possible
โ any
=> sentence distance : 23
โ line 76
โ library only if it is covering the legacy library specs. Make sure you confirm feature and performance parity at your arch board reviews.
โ None
=> sentence distance : None
โ line 90
โ numbers [version number] and below have been deprecated
โ None
=> sentence distance : None
โ line 91
โ [date-MM-YY]. We strongly encourage you to upgrade to the latest version to continue receiving updates.
โ None
=> sentence distance : None
โ line 103
โ older package, we recommend that you upgrade your code.
โ SDK
=> sentence distance : 55
โ line 111
โ programming language instructions.
โ best practices
=> sentence distance : 28
โ line 114
โ [date-MM/YY]. We strongly
โ None
=> sentence distance : None
โ line 116
โ [Migration Guide](https://aka.ms/azsdk) for guidance on upgrading.
โ language
=> sentence distance : 60
โ line 119
โ version.
โ None
=> sentence distance : None
โ line 121
โ with version numbers [version number] and below have been
โ managers
=> sentence distance : 53
โ line 122
โ upgrade to the latest version to
โ ensure
=> sentence distance : 30
โ line 128
โ are no longer maintained.
โ this new version's visibility
=> sentence distance : 23
โ line 131
โ no longer in use (new version has a different name), publish an update to the deprecated package after updating the README
โ elevated
=> sentence distance : 115
โ line 136
โ ship fixes for the legacy libraries for the next 3 years.
You will need to ship security and critical bug fixes for the first year.
You donโt have to proactively fix anything else, but a customer calling for support should be able to get it. Refer
โ recommended by default
=> sentence distance : 235
โ line 136
โ our [deprecation policy](https://azure.github.io/azure-sdk/policies_support.html) for more details.
โ None
=> sentence distance : None
โ line 139
โ [Azure Global Retirement Policy process](https://dev.azure.com/msazure/AzureWiki/_wiki/wikis/AzureWiki.wiki/37673/Retirements-and-Breaking-Changes).
โ users.
=> sentence distance : 142
โ line 234
โ Stable
โ GA
=> sentence distance : 6
โ line 236
โ stable
โ GA
=> sentence distance : 6
โ line 236
โ stable
โ GA
=> sentence distance : 6
โ line 236
โ stable
โ GA
=> sentence distance : 6
โ line 255
โ Alpha and Beta releases
โ GA-] releases the team also has [-prereleases
=> sentence distance : 30
โ line 255
โ None
โ GA
=> sentence distance : None
โ line 258
โ stable
โ GA
=> sentence distance : 6
โ line 258
โ stable
โ GA
=> sentence distance : 6
โ line 258
โ stable,
โ GA,
=> sentence distance : 6
โ line 270
โ **Stable
โ **GA
=> sentence distance : 6
โ line 270
โ stable
โ GA
=> sentence distance : 6
โ line 272
โ **Stable
โ **GA
=> sentence distance : 6
โ line 316
โ **Stable
โ **GA
=> sentence distance : 6
โ line 318
โ **Stable
โ **GA
=> sentence distance : 6
โ line 320
โ Stable
โ GA
=> sentence distance : 6
โ line 327
โ None
โ can be specified.
=> sentence distance : None
โ line 328
โ are automatically set based on
โ If none is provided,
=> sentence distance : 24
โ line 328
โ version being published and current versions present on npm and there is no need to set
โ `latest`
=> sentence distance : 81
โ line 328
โ manually when running a release pipeline.
โ gets used by default by the `npm publish` command.
=> sentence distance : 41
โ line 330
โ None
โ and tags
=> sentence distance : None
โ line 332
โ Stable
โ GA
=> sentence distance : 6
โ line 332
โ will get
โ should have
=> sentence distance : 9
โ line 333
โ version does not get any
โ ensure that-] the hotfix [-gets no
=> sentence distance : 24
โ line 333
โ None
โ ensure that
=> sentence distance : None
โ line 333
โ None
โ One way to do this is to use a dummy tag when publishing and deleting the tag afterwards.
=> sentence distance : None
โ line 334
โ stable, then
โ GA, ensure that the
=> sentence distance : 15
โ line 334
โ deleted from beta and latest tag will be set for stable version.
โ deleted.
=> sentence distance : 56
โ line 335
โ will get
โ should have
=> sentence distance : 9
โ line 336
โ Package version will also get
โ Additionally, use the
=> sentence distance : 23
โ line 336
โ stable
โ GA
=> sentence distance : 6
โ line 343
โ **Stable
โ **GA
=> sentence distance : 6
โ line 345
โ **Stable
โ **GA
=> sentence distance : 6
โ line 347
โ Stable
โ GA
=> sentence distance : 6
โ line 353
โ a stable release
โ GA'd
=> sentence distance : 16
โ line 377
โ **Stable
โ **GA
=> sentence distance : 6
โ line 379
โ **Stable
โ **GA
=> sentence distance : 6
โ line 381
โ Stable
โ GA
=> sentence distance : 6
โ line 396
โ **Stable
โ **GA
=> sentence distance : 6
โ line 398
โ **Stable
โ **GA
=> sentence distance : 6
โ line 400
โ Stable
โ GA
=> sentence distance : 6
โ line 412
โ **Stable
โ **GA
=> sentence distance : 6
โ line 414
โ **Stable
โ **GA
=> sentence distance : 6
โ line 426
โ **Stable
โ **GA
=> sentence distance : 6
โ line 428
โ **Stable
โ **GA
=> sentence distance : 6
โ line 443
โ **Stable
โ **GA
=> sentence distance : 6
โ line 445
โ **Stable
โ **GA
=> sentence distance : 6
โ line 457
โ **Stable
โ **GA
=> sentence distance : 6
โ line 459
โ **Stable
โ **GA
=> sentence distance : 6
โ line 473
โ **Beta Release for Initial Release:** `v0.1.0`
โ **Preview release:** `sdk//v0.1.0.`
=> sentence distance : 30
โ line 473
โ `v0.1.1`
โ `v0.2.0`
=> sentence distance : 2
โ line 477
โ **Stable
โ **GA
=> sentence distance : 6
โ line 477
โ `v1.0.0`
โ `sdk//v1.1.0`
=> sentence distance : 19
โ line 477
โ `v1.0.1`
โ `v1.2.0`
=> sentence distance : 2
โ line 479
โ **Stable
โ **GA
=> sentence distance : 6
โ line 481
โ Stable
โ GA
=> sentence distance : 6
โ line 512
โ stable,
โ GA,
=> sentence distance : 6
</details>293 words added. 127 words deleted.
Added words rate 6.56656207978485% (293 / 4462 words)
Deleted words rate 2.8462572837292694% (127 / 4462 words)
-
repostructure.md : File Modified +743 / -593 ๐ 634
โ line 2
โ "Policies: Repository Structure"
โ "์ ์ฑ : ์ ์ฅ์ ๊ตฌ์กฐ"
=> sentence distance : 27
โ line 8
โ To help make our repos more consistent and easier to approach from our team as well as the community we should have a consistent structure. That structure should avoid putting a lot of stuff in the root of the repo to make it appear neater and allow folks visiting the repo to quickly see the root README.md without needing to scroll. The directory structure should look like:
โ ํ๋ฟ๋ง ์๋๋ผ ์ปค๋ฎค๋ํฐ์์๋ ์ ์ฅ์๋ฅผ ๋ณด๋ค ์ผ๊ด๋๊ณ ์ฝ๊ฒ ์ ๊ทผํ ์ ์๋๋ก ํ๋ ค๋ฉด ์ผ๊ด๋ ๊ตฌ์กฐ๋ฅผ ๊ฐ์ถฐ์ผ ํฉ๋๋ค. ์ด๋ฌํ ๊ตฌ์กฐ๋ ์ ์ฅ์ ๋ฃจํธ์ ๋ง์ ๋ด์ฉ์ ๋ฐฐ์นํ์ง ์๋๋ก ํด์ผ ํ๋ฉฐ ์ ์ฅ์๋ฅผ ๋ฐฉ๋ฌธํ๋ ์ฌ๋๋ค์ด ์คํฌ๋กคํ์ง ์๊ณ ๋ ๋ฃจํธ README.md์ ๋น ๋ฅด๊ฒ ๋ณผ ์ ์๋๋ก ํด์ผ ํฉ๋๋ค. ๋๋ ํฐ๋ฆฌ ๊ตฌ์กฐ๋ ๋ค์๊ณผ ๊ฐ์ต๋๋ค:
=> sentence distance : 325
โ line 10
โ Will contain source code or projects that are not shipping artifacts but are shared and used by our sdk libraries. Things like common test projects or shared test or source code.
โ ๋ง๋ค์ด ์ง ๊ฒ์ ์ ๊ณตํ์ง ์์ง๋ง SDK ๋ผ์ด๋ธ๋ฌ๋ฆฌ์์ ๊ณต์ ๋ฐ ์ฌ์ฉํ๋ ์์ค ์ฝ๋ ๋๋ ํ๋ก์ ํธ๋ฅผ ํฌํจํฉ๋๋ค. ์ผ๋ฐ์ ์ธ ํ ์คํธ ํ๋ก์ ํธ๋ ๊ณต์ ํ ์คํธ ๋๋ ์์ค ์ฝ๋์ ๊ฐ์ ๊ฒ์ ๋๋ค.
=> sentence distance : 152
โ line 11
โ Contains documentation, usually in markdown files, for anything in the repo. It should also contain a README.md that states the purposes of all the folders under `doc`. ([Example](https://github.com/Azure/azure-sdk-for-python/blob/main/doc/README.md))
โ ์ ์ฅ์์ ๋ชจ๋ ํญ๋ชฉ์ ๋ํ ์ค๋ช ์(์ผ๋ฐ์ ์ผ๋ก Markdown ํ์ผ)๋ฅผ ํฌํจํฉ๋๋ค. ๋ํ `doc` ์๋์ ์๋ ๋ชจ๋ ํด๋์ ์ฉ๋๋ฅผ ์ค๋ช ํ๋ README.md์ ํฌํจํด์ผ ํฉ๋๋ค. ([์์ ](https://github.com/Azure/azure-sdk-for-python/blob/main/doc/README.md))
=> sentence distance : 144
โ line 12
โ Contains the set of documentation needed for developers that are contributing to the repository.
โ ์ ์ฅ์์ ๊ธฐ์ฌํ๋ ๊ฐ๋ฐ์์๊ฒ ํ์ํ ์ค๋ช ์ ๋ชจ์์ ํฌํจํฉ๋๋ค.
=> sentence distance : 89
โ line 13
โ Used to contain things needed by the engineering system to build, test, or perform other related tasks. It will usually contain configure files, build definitions, scripts and other tools (generally not checked in binaries).
โ ์์ง๋์ด๋ง ์์คํ ์ด ๋ค๋ฅธ ๊ด๋ จ ์์ ์ ๊ตฌ์ถ, ํ ์คํธ ๋๋ ์ํํ๋ ๋ฐ ํ์ํ ๊ฒ๋ค์ ํฌํจํ๋ ๋ฐ ์ฌ์ฉ๋ฉ๋๋ค. ์ผ๋ฐ์ ์ผ๋ก ๊ตฌ์ฑ ํ์ผ, ๋น๋ ์ ์, ์คํฌ๋ฆฝํธ ๋ฐ ๊ธฐํ ๋๊ตฌ(์ผ๋ฐ์ ์ผ๋ก ์ด์ง์์๋ ํ์ธ๋์ง ์์)๊ฐ ํฌํจ๋ฉ๋๋ค.
=> sentence distance : 195
โ line 14
โ Primary directory which will contain our sdk library source code. See below for more details on its layout.
โ SDK ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์์ค ์ฝ๋๋ฅผ ํฌํจํ ๊ธฐ๋ณธ ๋๋ ํฐ๋ฆฌ์ ๋๋ค. ๋ ์ด์์์ ๋ํ ์์ธํ ๋ด์ฉ์ ์๋๋ฅผ ์ฐธ์กฐํ์ญ์์ค.
=> sentence distance : 93
โ line 17
โ To accomplish that every azure-sdk language repo will put a
โ ์ด๋ฅผ ์ํด ๋ชจ๋ Azure-sdk ์ธ์ด ์ ์ฅ์๊ฐ ๋ฃจํธ์
=> sentence distance : 45
โ line 17
โ and a `sdk` folder in the root that will contain a folder for each service which will then contain a folder for each package associated with the service. It will be `sdk`, singular as opposed to plural, because we want developers to realize we only have one
โ ๋ฐ sdk ํด๋๋ฅผ ๋ฐฐ์นํ๊ณ , ์ด ํด๋์๋ ์๋น์ค์ ์ฐ๊ฒฐ๋ ๊ฐ ํจํค์ง์ ํด๋๊ฐ ํฌํจ๋ฉ๋๋ค. ๊ฐ๋ฐ์๋ค์ด ์ฐ๋ฆฌ๊ฐ
=> sentence distance : 240
โ line 17
โ sdk and not many.
โ sdk๋ฅผ ํ๋ ๊ฐ์ง๊ณ ์๊ณ ๋ง์ง ์๋ค๋ ๊ฒ์ ๊นจ๋ซ๊ธฐ๋ฅผ ์ํ๊ธฐ ๋๋ฌธ์ ์ฌ๋ฌ ๊ฐ์ sdk๊ฐ ์๋ ํ๋์ sdk๊ฐ ๋ ๊ฒ์ ๋๋ค.
=> sentence distance : 60
โ line 19
โ directory layout
โ ๋๋ ํฐ๋ฆฌ ๋ ์ด์์
=> sentence distance : 15
โ line 21
โ Every azure-sdk language repo will put a
โ ๋ชจ๋ azure ์ธ์ด ์ ์ฅ์๋ ๋ฃจํธ์
=> sentence distance : 31
โ line 21
โ and a `sdk` folder in the root that will contain a folder for each service which will then contain a folder for each package associated with the service. It will be `sdk`, singular as opposed to plural, because we want developers to realize we only have one
โ ๋ฐ sdk ํด๋๋ฅผ ๋ฐฐ์นํฉ๋๋ค. ์ด ํด๋์๋ ๊ฐ ์๋น์ค์ ๋ํ ํด๋๊ฐ ํฌํจ๋์ด ์๋น์ค์ ์ฐ๊ฒฐ๋ ๊ฐ ํจํค์ง์ ํด๋๊ฐ ํฌํจ๋ฉ๋๋ค. ๊ฐ๋ฐ์๋ค์ด ์ฐ๋ฆฌ๊ฐ
=> sentence distance : 235
โ line 21
โ sdk and not many.
โ sdk๋ฅผ ํ๋ ๊ฐ์ง๊ณ ์๊ณ ๋ง์ง ์๋ค๋ ๊ฒ์ ๊นจ๋ซ๊ธฐ๋ฅผ ์ํ๊ธฐ ๋๋ฌธ์ ์ฌ๋ฌ ๊ฐ์ sdk๊ฐ ์๋ ํ๋์ sdk๊ฐ ๋ ๊ฒ์ ๋๋ค.
=> sentence distance : 60
โ line 30
โ **``**
โ **`<์๋น์ค ์ด๋ฆ="">`**
=> sentence distance : 11
โ line 30
โ Should be the short name for the azure service. It will be used to group all the various packages for a given service, including the management and data-plane packages, as well as any multi-api (e.g. or different profile versions (e.g AzureStack). Any shared artifacts like release notes or versions should go into this root repo. These names should match across all the different language repos and by default should be what is in the specification folder in the
โ Azure ์๋น์ค์ ์ค์๋ง์ด์ด์ผ ํฉ๋๋ค. ๊ด๋ฆฌ ๋ฐ ๋ฐ์ดํฐ ํ๋ ์ธ ํจํค์ง๋ฅผ ๋น๋กฏํ ํน์ ์๋น์ค์ ๋ํ ๋ชจ๋ ๋ค์ํ ํจํค์ง์ ๋ฉํฐ api(์: ๋๋ ๋ค๋ฅธ ํ๋กํ์ผ ๋ฒ์ (์: AzureStack))๋ฅผ ๊ทธ๋ฃนํํ๋ ๋ฐ ์ฌ์ฉ๋ฉ๋๋ค. ๋ฆด๋ฆฌ์ค ์ ๋ณด ๋๋ ๋ฒ์ ๊ณผ ๊ฐ์ ๋ชจ๋ ๊ณต์ ์ฐ์ ๋ฌผ์ ์ด ๋ฃจํธ ์ ์ฅ์์ ์ ์ฅ๋์ด์ผ ํฉ๋๋ค. ์ด๋ฌํ ์ด๋ฆ์ ์๋ก ๋ค๋ฅธ ๋ชจ๋ ์ธ์ด ์ ์ฅ์์์ ์ผ์นํด์ผ ํ๋ฉฐ ๊ธฐ๋ณธ์ ์ผ๋ก
=> sentence distance : 395
โ line 30
โ repo.
โ ์ ์ฅ์์ ๊ท๊ฒฉ ํด๋์ ์์ด์ผ ํฉ๋๋ค.
=> sentence distance : 19
โ line 31
โ **``**
โ **`<ํจํค์ง ์ด๋ฆ="">`**
=> sentence distance : 11
โ line 31
โ Should be the name of the shipping package, or an abbreviation that distinguishes the given shipping artifact for the given service. The key is that there is source for only one shipping package in this folder.
โ ๋ฐฐ์ก ํจํค์ง์ ์ด๋ฆ ๋๋ ์ง์ ๋ ์๋น์ค์ ๋ํ ์ง์ ๋ ๋ฐฐ์ก ์ฐฝ์๋ฌผ์ ๊ตฌ๋ถํ๋ ์ฝ์ด์ฌ์ผ ํฉ๋๋ค. ์ค์ํ ๊ฒ์ ์ด ํด๋์ ํ๋์ ๋ฐฐ์ก ํจํค์ง์ ๋ํ ์์ค๊ฐ ์๋ค๋ ๊ฒ์ ๋๋ค.
=> sentence distance : 184
โ line 32
โ If there are multiple packages with the same name but different scope/org/groupid/SxS-version/etc then put them each in their own folder under the service name directory with names that match whatever distinguishes them from each other.
โ ์ด๋ฆ์ด ๊ฐ์ง๋ง scope/org/groupid/SxS-version ๋ฑ์ด ์๋ก ๋ค๋ฅธ ํจํค์ง๊ฐ ์ฌ๋ฌ ๊ฐ ์๋ ๊ฒฝ์ฐ ์๋ก ๊ตฌ๋ถ๋๋ ์ด๋ฆ๊ณผ ํจ๊ป ์๋น์ค ์ด๋ฆ ๋๋ ํฐ๋ฆฌ ์๋์ ๊ณ ์ ํ ํด๋์ ๊ฐ๊ฐ ๋ฃ์ต๋๋ค.
=> sentence distance : 184
โ line 33
โ If there are long file path issues then you can use an abbreviation of the package name to help avoid issues. For example
โ ํ์ผ ๊ฒฝ๋ก ๋ฌธ์ ๊ฐ ๊ธด ๊ฒฝ์ฐ ํจํค์ง ์ด๋ฆ์ ์ฝ์ด๋ฅผ ์ฌ์ฉํ์ฌ ๋ฌธ์ ๋ฅผ ๋ฐฉ์งํ ์ ์์ต๋๋ค. ์๋ฅผ ๋ค์ด
=> sentence distance : 106
โ line 33
โ tools require every part of the package/namespace to be a separate folder which can make the paths extra long and thus may need to abbreviate the package name to help alleviate the impact of long file paths on windows.
โ ๋๊ตฌ๋ package/namespace์ ๋ชจ๋ ๋ถ๋ถ์ ๋ณ๋์ ํด๋์ฌ์ผ ํ๋ฏ๋ก ๊ฒฝ๋ก๊ฐ ๋๋ฌด ๊ธธ ์ ์์ผ๋ฏ๋ก ๊ธด ํ์ผ ๊ฒฝ๋ก๊ฐ ์ฐฝ์ ๋ฏธ์น๋ ์ํฅ์ ์ํํ๊ธฐ ์ํด ํจํค์ง ์ด๋ฆ์ ์ถ์ฝํด์ผ ํ ์ ์์ต๋๋ค.
=> sentence distance : 175
โ line 34
โ If there are other assets that aren't shipping packages, such as shared libraries/source code or tools, they can also go in a folder under the service name directory.
โ ๊ณต์ ๋ผ์ด๋ธ๋ฌ๋ฆฌ/์์ค ์ฝ๋ ๋๋ ๋๊ตฌ์ ๊ฐ์ด ํจํค์ง๋ฅผ ์ ๊ณตํ์ง ์๋ ๋ค๋ฅธ ์์ฐ์ด ์๋ ๊ฒฝ์ฐ ์๋น์ค ์ด๋ฆ ๋๋ ํ ๋ฆฌ ์๋์ ํด๋๋ก ์ด๋ํ ์๋ ์์ต๋๋ค.
=> sentence distance : 145
โ line 35
โ Every package directory must contain the following:
โ ๋ชจ๋ ํจํค์ง ๋๋ ํฐ๋ฆฌ๋ ๋ค์์ ํฌํจํด์ผ ํฉ๋๋ค:
=> sentence distance : 45
โ line 36
โ A README.md in the package root folder that contains documentation for the package
โ ํจํค์ง ๋ฃจํธ ํด๋์ ํจํค์ง์ ๋ํ ์ค๋ช ์๊ฐ ๋ค์ด ์๋ README.md์ ๋๋ค.
=> sentence distance : 74
โ line 37
โ A folder which contains the source code for the library contained in the package in whatever format is appropriate for the specific language and tools.
โ ํจํค์ง์ ํฌํจ๋ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ์์ค ์ฝ๋๊ฐ ํน์ ์ธ์ด ๋ฐ ๋๊ตฌ์ ์ ํฉํ ํ์์ผ๋ก ๋ค์ด ์๋ ํด๋์ ๋๋ค.
=> sentence distance : 137
โ line 38
โ A folder which contains the test code for the library contained in the package in whatever format is appropriate for the specific language and tools.
โ ํจํค์ง์ ํฌํจ๋ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ํ ์คํธ ์ฝ๋๊ฐ ํน์ ์ธ์ด ๋ฐ ๋๊ตฌ์ ์ ํฉํ ํ์์ผ๋ก ๋ค์ด ์๋ ํด๋์ ๋๋ค.
=> sentence distance : 135
โ line 39
โ A folder which contains sample code for the library contained in the package in whatever format is appropriate for the specific language and tools.
โ ํน์ ์ธ์ด ๋ฐ ๋๊ตฌ์ ์ ํฉํ ํ์์ผ๋ก ํจํค์ง์ ํฌํจ๋ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ์ํ ์ฝ๋๊ฐ ๋ค์ด ์๋ ํด๋์ ๋๋ค.
=> sentence distance : 133
โ line 43
โ The azure-sdk language repositories will sometimes contain modules/libraries/packages which provide integration between popular application frameworks as Azure services. For example Spring Boot, Spring Data, or ASP.NET. In general the modules that provide integration with a specific service should be co-located with the other modules for that service. In very limited circumstances an application framework may contains shared logic used across multiple integrations, or all integrations are in a single module. In those cases the module may be placed in a directory named after the application framework (e.g. ```sdk/spring/```).
โ #### ์ ํ๋ฆฌ์ผ์ด์ ํ๋ ์์ํฌ์ ๋ํ ํน๋ณํ ๊ณ ๋ ค ์ฌํญ
=> sentence distance : 626
โ line 45
โ Examples:
โ Azure-sdk ์ธ์ด ์ ์ฅ์์๋ Azure ์๋น์ค๋ก ๋๋ฆฌ ์ฌ์ฉ๋๋ ์ ํ๋ฆฌ์ผ์ด์ ํ๋ ์์ํฌ ๊ฐ์ ํตํฉ์ ์ ๊ณตํ๋ ๋ชจ๋/๋ผ์ด๋ธ๋ฌ๋ฆฌ/ํจํค์ง๊ฐ ํฌํจ๋ ์ ์์ต๋๋ค. ์๋ฅผ ๋ค์ด ์คํ๋ง ๋ถํธ, ์คํ๋ง ๋ฐ์ดํฐ ๋๋ ASP.NET๊ฐ ์์ต๋๋ค. ์ผ๋ฐ์ ์ผ๋ก ํน์ ์๋น์ค์์ ํตํฉ์ ์ ๊ณตํ๋ ๋ชจ๋์ ํด๋น ์๋น์ค์ ๋ค๋ฅธ ๋ชจ๋๊ณผ ํจ๊ป ๋ฐฐ์นํด์ผ ํฉ๋๋ค. ๋งค์ฐ ์ ํ๋ ์ํฉ์์ ์ ํ๋ฆฌ์ผ์ด์ ํ๋ ์์ํฌ๋ ์ฌ๋ฌ ํตํฉ์์ ์ฌ์ฉ๋๋ ๊ณต์ ๋ ผ๋ฆฌ๋ฅผ ํฌํจํ๊ฑฐ๋ ๋ชจ๋ ํตํฉ์ด ๋จ์ผ ๋ชจ๋์ ํฌํจ๋ ์ ์์ต๋๋ค. ์ด ๊ฒฝ์ฐ ๋ชจ๋์ ์์ฉ ํ๋ก๊ทธ๋จ ํ๋ ์์ํฌ์ ์ด๋ฆ์ ๋ด ๋๋ ํ ๋ฆฌ์ ๋ฐฐ์น๋ ์ ์์ต๋๋ค. (e.g. ```sdk/spring/```).-]### [-์์ :
=> sentence distance : 343
โ line 45
โ None
โ Azure-sdk ์ธ์ด ์ ์ฅ์์๋ Azure ์๋น์ค๋ก ๋๋ฆฌ ์ฌ์ฉ๋๋ ์ ํ๋ฆฌ์ผ์ด์ ํ๋ ์์ํฌ ๊ฐ์ ํตํฉ์ ์ ๊ณตํ๋ ๋ชจ๋/๋ผ์ด๋ธ๋ฌ๋ฆฌ/ํจํค์ง๊ฐ ํฌํจ๋ ์ ์์ต๋๋ค. ์๋ฅผ ๋ค์ด ์คํ๋ง ๋ถํธ, ์คํ๋ง ๋ฐ์ดํฐ ๋๋ ASP.NET๊ฐ ์์ต๋๋ค. ์ผ๋ฐ์ ์ผ๋ก ํน์ ์๋น์ค์์ ํตํฉ์ ์ ๊ณตํ๋ ๋ชจ๋์ ํด๋น ์๋น์ค์ ๋ค๋ฅธ ๋ชจ๋๊ณผ ํจ๊ป ๋ฐฐ์นํด์ผ ํฉ๋๋ค. ๋งค์ฐ ์ ํ๋ ์ํฉ์์ ์ ํ๋ฆฌ์ผ์ด์ ํ๋ ์์ํฌ๋ ์ฌ๋ฌ ํตํฉ์์ ์ฌ์ฉ๋๋ ๊ณต์ ๋ ผ๋ฆฌ๋ฅผ ํฌํจํ๊ฑฐ๋ ๋ชจ๋ ํตํฉ์ด ๋จ์ผ ๋ชจ๋์ ํฌํจ๋ ์ ์์ต๋๋ค. ์ด ๊ฒฝ์ฐ ๋ชจ๋์ ์์ฉ ํ๋ก๊ทธ๋จ ํ๋ ์์ํฌ์ ์ด๋ฆ์ ๋ด ๋๋ ํ ๋ฆฌ์ ๋ฐฐ์น๋ ์ ์์ต๋๋ค. (e.g. ```sdk/spring/```).
=> sentence distance : None
</details>743 words added. 593 words deleted.
Added words rate 117.19242902208202% (743 / 634 words)
Deleted words rate 93.53312302839116% (593 / 634 words)
-
reviewprocess.md : File Modified +18 / -17 ๐ 2001
โ line 10
โ SDK
โ Developer Platform (ADP)
=> sentence distance : 23
โ line 10
โ None
โ Review
=> sentence distance : None
โ line 47
โ Board](mailto:azsdkarch@microsoft.com)
โ Board](mailto:adparch@microsoft.com)
=> sentence distance : 3
โ line 98
โ stable.**
โ GA.**
=> sentence distance : 6
โ line 163
โ stable.
โ GA.
=> sentence distance : 6
โ line 163
โ moves to stable.
โ GAs.
=> sentence distance : 14
โ line 163
โ stable
โ GA
=> sentence distance : 6
โ line 163
โ a stable release.
โ GA.
=> sentence distance : 16
โ line 172
โ a stable release,
โ it is in GA,
=> sentence distance : 14
โ line 174
โ the release.
โ GA.
=> sentence distance : 11
โ line 174
โ stable
โ GA
=> sentence distance : 6
โ line 174
โ stable)
โ GA)
=> sentence distance : 6
18 words added. 17 words deleted.
Added words rate 0.8995502248875562% (18 / 2001 words)
Deleted words rate 0.8495752123938031% (17 / 2001 words)
-
support.md : File Modified +450 / -411 ๐ 487
โ line 2
โ "Policies: Support"
โ "์ ์ฑ : ์ง์"
=> sentence distance : 15
โ line 8
โ SDK lifecycle and support policy**
โ SDK์ ์๋ช ์ฃผ๊ธฐ ๋ฐ ์ง์ ์ ์ฑ **
=> sentence distance : 26
โ line 10
โ SDK Lifecycle and support are governed by the latest [Microsoft
โ SDK์ ์๋ช ์ฃผ๊ธฐ์ ์ง์์ ์๋ ์ ๋ณด์ ์ถฉ๋ํ๋ ๊ฒฝ์ฐ ์ฐ์ธํ ์ต์ [Microsoft
=> sentence distance : 43
โ line 10
โ Policy](https://docs.microsoft.com/en-US/lifecycle/policies/modern), which will prevail in case of any conflicts with the information below.
โ Policy](https://docs.microsoft.com/en-US/lifecycle/policies/modern)์ ์ ์ฉ์ ๋ฐ์ต๋๋ค.
=> sentence distance : 70
โ line 12
โ **Package lifecycle**
โ **ํจํค์ง ์๋ช ์ฃผ๊ธฐ**
=> sentence distance : 16
โ line 14
โ Here are the stages of a typical package lifecycle (for major versions)
โ ๋ค์์ ์ผ๋ฐ์ ์ธ ํจํค์ง ์๋ช ์ฃผ๊ธฐ ๋จ๊ณ์ ๋๋ค(์ฃผ์ ๋ฒ์ ์ฉ).
=> sentence distance : 64
โ line 16
โ **Beta**
โ **๋ฒ ํ**
=> sentence distance : 4
โ line 16
โ A new SDK that is available for early access and feedback purposes and is not recommended for use in production.
โ ์กฐ๊ธฐ ์ก์ธ์ค ๋ฐ ํผ๋๋ฐฑ์ ์ํด ์ฌ์ฉํ ์ ์๋ ์๋ก์ด SDK๋ก ์ค๊ฐ๋์์๋ ์ฌ์ฉํ์ง ์๋ ๊ฒ์ด ์ข์ต๋๋ค. ๋ฒ ํ ๋ฒ์ ์ง์์
=> sentence distance : 97
โ line 17
โ issues and response time is not guaranteed. Beta releases live typically for less than 1 year, after which they are either deprecated or released as stable.
โ ๋ฌธ์ ๋ก ํ์ ๋๋ฉฐ ์๋ต ์๊ฐ์ ๋ณด์ฅ๋์ง ์์ต๋๋ค. ๋ฒ ํ ๋ฆด๋ฆฌ์ค๋ ์ผ๋ฐ์ ์ผ๋ก 1๋ ๋ฏธ๋ง์ด๋ฉฐ ๊ทธ ํ ํ๊ธฐ๋๊ฑฐ๋ GA์ ์ถ์๋ฉ๋๋ค.
=> sentence distance : 139
โ line 19
โ **Active**
โ **ํ์ฑ**
=> sentence distance : 6
โ line 19
โ The SDKs are generally available and fully supported, will receive new feature updates, as well as bug and security fixes.
โ SDK๋ ์ผ๋ฐ์ ์ผ๋ก ์ด์ฉ ๊ฐ๋ฅํ๋ฉฐ ์์ ํ ์ง์๋๋ฉฐ ์๋ก์ด ๊ธฐ๋ฅ ์ ๋ฐ์ดํธ์ ๋ฒ๊ทธ ๋ฐ ๋ณด์ ์์ ์ด ์ ๊ณต๋ฉ๋๋ค. ๋ฉ์ด์ ๋ฒ์ ์ ์ถ์์ผ๋ก๋ถํฐ ์ต์ 12๊ฐ์ ๋์ ํ์ฑํ๋ฉ๋๋ค. ๋ฉ์ด์ ๋ฆด๋ฆฌ์ค์ ํธํ๋๋ ์ ๋ฐ์ดํธ๋ ๋ง์ด๋๋ฒ์ ๋๋ ํจ์น๋ฒ์ ์ ํตํด ์ ๊ณต๋ฉ๋๋ค. ์ต์ ๋ฒ์ ์ ์์ ๋ฐ ์ ๋ฐ์ดํธ๋ฅผ ๋ฐ์ ์ ์์ผ๋ฏ๋ก ์ต์ ๋ฒ์ ์ ์ฌ์ฉํ๋ ๊ฒ์ด ์ข์ต๋๋ค.
=> sentence distance : 167
โ line 23
โ **Deprecated**
โ **์ ์ง ๊ด๋ฆฌ**
=> sentence distance : 10
โ line 23
โ A library no longer conforms to our most up-to-date [Azure SDK Guidelines](https://azure.github.io/azure-sdk/general_introduction.html), or has been superseded by a more recent release. In both cases, the current library is deprecated in favor of a newer library. Typically, deprecation occurs at the same time the replacement library is transitioned to Active, after which the releases will only address the most critical bug fixes and security fixes for at least another 12 months.
โ ํต์ ์ ์ง ๊ด๋ฆฌ ๋ชจ๋๋ ๋ค์ ๋ฉ์ด์ ๋ฒ์ ์ด ์กํฐ๋ธ๋ก ์ ํ๋๋ ๋์์ ๋ฐํ๋๋ฉฐ, ๊ทธ ํ ๋ฆด๋ฆฌ์ฆ์์๋ ์ต์ 12๊ฐ์ ๋์ ๊ฐ์ฅ ์ค์ํ ๋ฒ๊ทธ ์์ ๋ฐ ๋ณด์ ์์ ์ฌํญ๋ง ํด๊ฒฐํฉ๋๋ค.
=> sentence distance : 456
โ line 25
โ **Community**
โ **์ปค๋ฎค๋ํฐ**
=> sentence distance : 9
โ line 25
โ SDK will no longer receive updates from Microsoft unless otherwise specified in the separate customer agreement.
โ SDK๋ ๊ณ ๊ฐ ๊ณ์ฝ์ ๋ณ๋๋ก ๋ช ์๋์ง ์๋ ํ Microsoft๋ก๋ถํฐ ์ ๋ฐ์ดํธ๋ฅผ ๋ฐ์ง ์์ต๋๋ค. ํจํค์ง๋ ๊ณต์ฉ ํจํค์ง ๊ด๋ฆฌ์์ ์ปค๋ฎค๋ํฐ์์ ์ ์ง ๊ด๋ฆฌํ ์ ์๋
=> sentence distance : 89
โ line 26
โ repo, which can be maintained by the community.
โ repo๋ฅผ ํตํด ๊ณ์ ์ฌ์ฉํ ์ ์์ต๋๋ค.
=> sentence distance : 37
โ line 28
โ You can check the lifecycle stage for your package at [this page](https://azure.github.io/azure-sdk/releases/latest/index.html)
โ ํจํค์ง์ ์๋ช ์ฃผ๊ธฐ ๋จ๊ณ๋ฅผ ํ์ธํ ์ ์์ต๋๋ค. [์ด ํ์ด์ง์์](https://azure.github.io/azure-sdk/releases/latest/index.html)
=> sentence distance : 56
โ line 30
โ Clouds**
โ ํด๋ผ์ฐ๋**
=> sentence distance : 6
โ line 32
โ By default, the
โ ๊ธฐ๋ณธ์ ์ผ๋ก
=> sentence distance : 15
โ line 32
โ libraries are configured to connect to the Global
โ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ ์ ์ญ
=> sentence distance : 48
โ line 32
โ Cloud.
โ ํด๋ผ์ฐ๋์ ์ฐ๊ฒฐํ๋๋ก ๊ตฌ์ฑ๋ฉ๋๋ค.
=> sentence distance : 17
โ line 33
โ Stack,
โ ์คํ,
=> sentence distance : 5
โ line 33
โ and Government Cloud.
โ ๋ฐ ์ ๋ถ ํด๋ผ์ฐ๋์ ๊ฐ์ ์ถ๊ฐ ํด๋ผ์ฐ๋ ๋์ ํ๋ซํผ์ ์ฌ์ฉํ ์ ์์ต๋๋ค. ํจํค์ง ์๋ช ์ฃผ๊ธฐ๋ ๋์ ํ๋ซํผ์ ๋ฐ๋ผ ๋ค๋ฅผ ์ ์์ต๋๋ค. ์์ธํ ๋ด์ฉ์ ๋์ ํ๋ซํผ ๋ฉ๋ด์ผ์ ์ฐธ์กฐํด ์ฃผ์ธ์.
=> sentence distance : 100
โ line 36
โ dependencies**
โ ์ข ์์ฑ**
=> sentence distance : 12
โ line 38
โ libraries depend on
โ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋
=> sentence distance : 19
โ line 38
โ programming language runtime, OS, and third-party libraries.
โ ํ๋ก๊ทธ๋๋ฐ ์ธ์ด ๋ฐํ์, OS ๋ฐ ํ์ฌ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ์์กดํฉ๋๋ค.
=> sentence distance : 50
โ line 40
โ libraries will not be guaranteed to work on platforms and with other dependencies that have reached their end of life. Dropping support for such dependencies may be done without increasing the major version of the
โ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ ํ๋ซํผ ๋ฐ ์๋ช ์ด ๋คํ ๋ค๋ฅธ ์์กด ๊ด๊ณ์์ ๋์ํ๋ ๊ฒ์ ๋ณด์ฆํ์ง ์์ต๋๋ค.
=> sentence distance : 201
โ line 40
โ libraries. We strongly recommend migration to supported platforms and other dependencies to be eligible for technical support.
โ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ๋ฉ์ด์ ๋ฒ์ ์ ๋๋ฆฌ์ง ์๊ณ ์ด๋ฌํ ์์กด๊ด๊ณ์ ๋ํ ์ง์์ ํ๊ธฐํ ์ ์์ต๋๋ค. ๊ธฐ์ ์ง์์ ๋ฐ์ ์ ์๋๋ก ์ง์ ํ๋ซํผ ๋ฐ ๊ธฐํ ์์กด๊ด๊ณ๋ก ์ดํํ ๊ฒ์ ๊ฐ๋ ฅํ ๊ถ์ฅํฉ๋๋ค.
=> sentence distance : 110
โ line 40
โ The
โ None
=> sentence distance : None
โ line 42
โ Below is a list of supported
โ ๋ค์์ ์ง์๋๋
=> sentence distance : 27
โ line 42
โ platforms and runtimes for your reference:
โ ํ๋ซํผ ๋ฐ ๋ฐํ์ ๋ชฉ๋ก์ ๋๋ค:
=> sentence distance : 38
โ line 44
โ **Operating Systems:**
โ **์ด์ ์ฒด์ :**
=> sentence distance : 16
โ line 44
โ None
โ (Ubuntu 18.04์์ ํ ์คํธ)
=> sentence distance : None
โ line 45
โ (tested on Ubuntu 18.04)
โ ๋ชจ๋ฐ์ผ ๊ฐ๋ฐ์ ๊ฒฝ์ฐ
=> sentence distance : 22
โ line 46
โ supported platforms](https://azure.github.io/azure-sdk/ios_design.html#ios-library-support), and the
โ ์ง์ ํ๋ซํผ](https://azure.github.io/azure-sdk/ios_design.html#ios-library-support)๊ณผ
=> sentence distance : 27
โ line 46
โ supported platforms](https://azure.github.io/azure-sdk/android_design.html)
โ ์ง์ ํ๋ซํผ](https://azure.github.io/azure-sdk/android_design.html)์ ํ์ธํ์ญ์์ค.
=> sentence distance : 27
โ line 48
โ **Runtime:**
โ **๋ฐํ์:**
=> sentence distance : 7
โ line 50
โ versions](https://dotnet.microsoft.com/en-us/platform/support/policy/dotnet-core) that implement
โ ํ์ค 2.0์ ์ง์ํ๋ ๋ชจ๋ ํ๋ซํผ.
=> sentence distance : 93
โ line 50
โ Standard 2.0.
โ ํ๋ ์์ํฌ 4.6.1 ๋ฐ .NET ์ฝ์ด 2.1, .NET 5.0์์ ํ ์คํธ
=> sentence distance : 37
โ line 52
โ [LTS versions of Node.js](https://nodejs.org/about/releases/) including not just the ones in Active status, but also the ones in Maintainence status.
โ [Node.js์ LTS ๋ฒ์ ](https://nodejs.org/about/releases/) ์๋ ํ์ฑ ์ํ์ LTS ๋ฒ์ ๋ฟ๋ง ์๋๋ผ ์ ์ง ๊ด๋ฆฌ ์ํ์ LTS ๋ฒ์ ๋ ํฌํจ๋ฉ๋๋ค.
=> sentence distance : 95
โ line 53
โ 3.6+
โ 3.5+, 2.7
=> sentence distance : 6
โ line 54
โ releases, refer to [Go releases](https://golang.org/doc/devel/release.html) for more details.
โ runtimeโ ์ต์ ๋ฉ์ด์ Go ๋ฆด๋ฆฌ์ฆ 2๊ฐ๋ฅผ ์ง์ํ๊ณ ์์ต๋๋ค. ์์ธํ ๋ด์ฉ์ https://golang.org/doc/devel/release.html ๋ฅผ ์ฐธ์กฐํด ์ฃผ์ธ์.
=> sentence distance : 55
โ line 56
โ Embedded C: Refer to the list of supported platforms and compilers [here](https://azure.github.io/azure-sdk/clang_design.html#supported-platforms).
โ C์ ๊ฒฝ์ฐ [์ฌ๊ธฐ](https://azure.github.io/azure-sdk/clang_design.html)์์ ์ง์๋๋ ํ๋ซํผ ๋ฐ ์ปดํ์ผ๋ฌ ๋ชฉ๋ก์ ์ฐธ์กฐํ์ญ์์ค.
=> sentence distance : 98
โ line 58
โ None
โ **ํ ์คํธ ๊ตฌ์ฑ:**
=> sentence distance : None
โ line 60
โ **Test configurations:**
โ ๋ค์์ ๋ค์ํ ์ด์ ์ฒด์ ๋ฐ ๋ฐํ์์ ์ ์ฉ๋๋ ํ ์คํธ ๊ตฌ์ฑ์ ๋๋ค. ์ง์์ ์ค๋จํ๋ ์ผ๋ถ ๋ฐ์ ๋ฒ์ ๊ณผ ์์ง ๊ณต์์ ์ผ๋ก ์ง์๋์ง ์๋ ์์ ๋ฒ์ ์ด ํ์๋ ์ ์์ต๋๋ค. ๊ณต์์ ์ผ๋ก ์ง์๋๋ ์ธํธ์ ๋ํด์๋ ์ด์ ์น์ ์ ์ธ๋ถ ์ ๋ณด๋ฅผ ์ฐธ์กฐํ์ญ์์ค.
=> sentence distance : 132
โ line 62
โ None
โ - [.NET ํ ์คํธ ๊ตฌ์ฑ](https://github.com/Azure/azure-sdk-for-java/blob/main/eng/pipelines/templates/stages/platform-matrix.json)
=> sentence distance : None
โ line 63
โ None
โ - [Java ํ ์คํธ ๊ตฌ์ฑ](https://github.com/Azure/azure-sdk-for-java/blob/main/eng/pipelines/templates/stages/platform-matrix.json)
=> sentence distance : None
โ line 64
โ None
โ - [JavaScript ํ ์คํธ ๊ตฌ์ฑ](https://github.com/Azure/azure-sdk-for-js/blob/main/eng/pipelines/templates/stages/platform-matrix.json)
=> sentence distance : None
โ line 65
โ Below are the test configurations covering different operating systems and runtimes. You may see some outgoing versions for which we are dropping support or incoming versions that we don't officially support yet. Please see the details in the previous section for the officially supported set.
โ - [Python ํ ์คํธ ๊ตฌ์ฑ](https://github.com/Azure/azure-sdk-for-python/blob/main/eng/pipelines/templates/stages/platform-matrix.json)
=> sentence distance : 242
โ line 67
โ - [.NET test configuration](https://github.com/Azure/azure-sdk-for-net/blob/main/eng/pipelines/templates/stages/platform-matrix.json)
โ ### **์ง์**:
=> sentence distance : 131
โ line 74
โ ### **Support**:
โ ์ง์ ๊ณํ์ด ์๋ ๊ณ ๊ฐ์ [์ฌ๊ธฐ](https://azure.microsoft.com/en-us/support/create-ticket/)์์
=> sentence distance : 71
โ line 76
โ Support ticket [here](https://azure.microsoft.com/en-us/support/create-ticket/)
โ ์ง์ ํฐ์ผ์ ์ด ์ ์์ต๋๋ค. [Azure SDK
=> sentence distance : 73
โ line 77
โ issues [in the Azure SDK
โ ์ ์ฅ์](https://github.com/Azure/azure-sdk/blob/main/README.md)์์
=> sentence distance : 53
โ line 77
โ repositories](https://github.com/Azure/azure-sdk/blob/main/README.md) to track bugs and feature requests.
โ ๋ฌธ์ ๋ฅผ ์ด์ด ๋ฒ๊ทธ ๋ฐ ๊ธฐ๋ฅ ์์ฒญ์ ์ถ์ ํ ์ ์์ต๋๋ค.
=> sentence distance : 98
โ line 77
โ issues are free, but may take a longer time to process.
โ ๋ฌธ์ ๋ ๋ฌด๋ฃ์ด์ง๋ง ์ฒ๋ฆฌ ์๊ฐ์ด ์ค๋ ๊ฑธ๋ฆด ์ ์์ต๋๋ค.
=> sentence distance : 47
450 words added. 411 words deleted.
Added words rate 92.40246406570843% (450 / 487 words)
Deleted words rate 84.39425051334702% (411 / 487 words)
-
-
python
-
design.md : File Modified +286 / -217 ๐ 7225
โ line 15
โ Idiomatic
โ ๊ด์ต์ (Idiomatic)
=> sentence distance : 6
โ line 17
โ The SDK should follow the design guidelines and conventions for the target language. It should feel natural to a developer in the target language.
โ SDK๋ ๋์ ์ธ์ด์ ๋ํ ๋์์ธ ๊ฐ์ด๋๋ผ์ธ ๋ฐ ๊ท์น์ ๋ฐ๋ผ์ผ ํฉ๋๋ค. ํด๋น ์ธ์ด์ ๊ฐ๋ฐ์๊ฐ ์์ฐ์ค๋ฝ๊ฒ ๋ฐ์๋ค์ผ ์ ์์ด์ผ ํฉ๋๋ค.
=> sentence distance : 124
โ line 18
โ We embrace the ecosystem with its strengths and its flaws.
โ ์ฐ๋ฆฌ๋ ์ํ๊ณ์ ์ฅ์ ๊ณผ ๋จ์ ์ ํจ๊ป ํฌ๊ดํฉ๋๋ค.
=> sentence distance : 52
โ line 19
โ We work with the ecosystem to improve it for all developers.
โ ์ฐ๋ฆฌ๋ ๋ชจ๋ ๊ฐ๋ฐ์๋ค์ ์ํ ์ํ๊ณ๋ฅผ ๊ฐ์ ์ํค๊ธฐ ์ํด ํ๋ ฅํฉ๋๋ค.
=> sentence distance : 52
โ line 21
โ Consistent
โ ์ผ๊ด์ฑ (Consistent)
=> sentence distance : 6
โ line 23
โ Client libraries should be consistent within the language, consistent with the service and consistent between all target languages. In cases of conflict, consistency within the language is the highest priority and consistency between all target languages is the lowest priority.
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ ์ธ์ด ๋ด์์ ์ผ๊ด์ฑ์ด ์์ด์ผ ํ๋ฉฐ, ์๋น์ค์ ๋์ ์ธ์ด ๊ฐ์ ์ผ๊ด์ฑ์ด ์์ด์ผ ํฉ๋๋ค. ์ถฉ๋์ด ๋ฐ์ํ๋ฉด, ์ฐ์ ์ธ์ด ๋ด์ ์ผ๊ด์ฑ์ ๊ฐ์ฅ ๋์ ์ฐ์ ์์๋ฅผ ๊ฐ์ง๊ณ , ๋ชจ๋ ๋์์ ์ธ์ด ๊ฐ์ ์ผ๊ด์ฑ์ ๊ฐ์ฅ ๋ฎ์ ์ฐ์ ์์๋ก ๊ฐ์ง๋๋ค.
=> sentence distance : 242
โ line 24
โ Service-agnostic concepts such as logging,
โ ๋ก๊น ,
=> sentence distance : 41
โ line 24
โ communication, and error handling should be consistent. The developer should not have to relearn service-agnostic concepts as they move between client libraries.
โ ํต์ , ์์ธ ์ฒ๋ฆฌ ๊ฐ์ ์๋น์ค-์ด๊ทธ๋ ธ์คํฑ(Service-agnostic)์ ์ผ๊ด์ฑ์ด ์์ด์ผ ํ๋ฉฐ ๊ฐ๋ฐ์๋ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ค ๊ฐ์ ์ด๋ํ ๋ ์๋น์ค-์ด๊ทธ๋ ธ์คํฑ(Service-agnostic)์ ๋ค์ ํ์ตํ ํ์๊ฐ ์์ด์ผ ํฉ๋๋ค.
=> sentence distance : 133
โ line 25
โ Consistency of terminology between the client library and the service is a good thing that aids in diagnosability.
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ์๋น์ค ์ฌ์ด์ ์ฉ์ด์ ์ผ๊ด์ฑ์ ๋ถ์์ ๋์์ด ๋๋ค.
=> sentence distance : 105
โ line 26
โ All differences between the service and client library must have a good (articulated) reason for existing, rooted in idiomatic usage rather than whim.
โ ์๋น์ค์ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์ฌ์ด์ ๋ชจ๋ ์ฐจ์ด์ ์ ๋ณ๋๋ณด๋ค๋ ๊ด์ฉ์ ์ธ ์ฌ์ฉ์ ๋ฟ๋ฆฌ๋ฅผ ๋ ํ์กดํ๋ ํ๋นํ(๋ถ๋ช ํ ํํ๋) ์ด์ ๊ฐ ์์ด์ผ ํฉ๋๋ค.
=> sentence distance : 133
โ line 27
โ The
โ ๊ฐ ๋์ ์ธ์ด์ ๋ํ
=> sentence distance : 11
โ line 27
โ SDK for each target language feels like a single product developed by a single team.
โ SDK๋ ํ๋์ ํ์ด ๊ฐ๋ฐํ ํ๋์ ์ ํ์ฒ๋ผ ๋๊ปด์ ธ์ผ ํฉ๋๋ค.
=> sentence distance : 73
โ line 28
โ There should be feature parity across target languages. This is more important than feature parity with the service.
โ ๋์ ์ธ์ด ๊ฐ์ ๊ธฐ๋ฅ ๋๋ฑ์ฑ์ด ์์ด์ผ ํฉ๋๋ค. ์ด๊ฒ์ ์๋น์ค์์ ๊ธฐ๋ฅ ๋๋ฑ์ฑ๋ณด๋ค ๋ ์ค์ํฉ๋๋ค.
=> sentence distance : 102
โ line 30
โ Approachable
โ ์ ๊ทผํ๊ธฐ์ฝ๊ฒ
=> sentence distance : 12
โ line 32
โ We are experts in the supported technologies so our customers, the developers, don't have to be.
โ ์ฐ๋ฆฌ๋ ์ง์๋๋ ๊ธฐ์ ๋ค์ ์ ๋ฌธ๊ฐ๋ก ์ฐ๋ฆฌ์ ๊ณ ๊ฐ๋ค๊ณผ ๊ฐ๋ฐ์๋ค์ ์ ๋ฌธ์ฑ์ ๊ฐ์ง ํ์๊ฐ ์์ต๋๋ค.
=> sentence distance : 85
โ line 33
โ Developers should find great documentation (hero tutorial, how to articles, samples, and
โ ๊ฐ๋ฐ์๋ค์ Azure ์๋น์ค๋ฅผ ์ฑ๊ณต์ ์ผ๋ก ์ฌ์ฉํ๊ธฐ ์ฝ๊ฒ ํด์ฃผ๋ ์ข์ ๋ฌธ์(ํํ ๋ฆฌ์ผ, ๋ฐฉ๋ฒ ๋ฌธ์, ์ํ๋ค ๋ฐ
=> sentence distance : 75
โ line 33
โ documentation) that makes it easy to be successful with the Azure service.
โ ๋ฌธ์)๋ฅผ ์ฐพ์์ผ ํฉ๋๋ค.
=> sentence distance : 70
โ line 34
โ Getting off the ground should be easy through the use of predictable defaults that implement best practices. Think about progressive concept disclosure.
โ ๋ชจ๋ฒ ์ฌ๋ก๋ฅผ ๊ตฌํํ๋ ์์ธก ๊ฐ๋ฅํ ๊ธฐ๋ณธ๊ฐ๋ค์ ์ฌ์ฉํจ์ผ๋ก์จ ์ฝ๊ฒ ์์ํ ์ ์์ต๋๋ค. ์ ์ง์ ์ธ ๊ฐ๋ ์ ๊ณต๊ฐ์ ๋ํด ์๊ฐํด๋ณด์ธ์.
=> sentence distance : 135
โ line 35
โ The SDK should be easily acquired through the most normal mechanisms in the target language and ecosystem.
โ SDK๋ ๋ชฉํํ๋ ์ธ์ด์ ์ํ๊ณ ์์์ ๊ฐ์ฅ ํ๋ฒํ ๋ฐฉ๋ฒ์ ํตํด ์ฝ๊ฒ ์ป์ ์ ์์ด์ผ ํฉ๋๋ค.
=> sentence distance : 89
โ line 36
โ Developers can be overwhelmed when learning new service concepts. The core use cases should be discoverable.
โ ๊ฐ๋ฐ์๋ค์ ์๋ก์ด ์๋น์ค ๊ฐ๋ ์ ๋ฐฐ์ธ ๋ ์๋๋นํ ์ ์์ต๋๋ค. ํต์ฌ ์ฌ์ฉ ์ฌ๋ก๋ค์ ์ฝ๊ฒ ๋ฐ๊ฒฌํ ์ ์์ด์ผ ํฉ๋๋ค.
=> sentence distance : 93
โ line 749
โ stable
โ GA
=> sentence distance : 6
286 words added. 217 words deleted.
Added words rate 3.958477508650519% (286 / 7225 words)
Deleted words rate 3.003460207612457% (217 / 7225 words)
-
documentation.md : File Modified +601 / -438 ๐ 615
โ line 2
โ "Python Guidelines: Documentation"
โ "ํ์ด์ฌ ์๋ด์ : ๋ฌธ์"
=> sentence distance : 29
โ line 9
โ None
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ํฌํจํด์ผ ํ๋ ๋ช ๊ฐ์ง ๋ฌธ์ ์๋ฃ๊ฐ ์์ต๋๋ค.
=> sentence distance : None
โ line 10
โ There are several documentation deliverables that must be included in or as a companion to your client library. Beyond complete and helpful
โ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์๋ ์ฝ๋ ์์ฒด ๋ด์ ์ ์ฉํ
=> sentence distance : 134
โ line 10
โ documentation within the code itself (docstrings), you need a great
โ ์ค๋ช ์ ์ธ์๋
=> sentence distance : 66
โ line 10
โ and other supporting documentation.
โ ๋ฐ ๊ธฐํ ์ง์ ๋ฌธ์๊ฐ ํ์ํฉ๋๋ค.
=> sentence distance : 31
โ line 12
โ repository; includes package installation and client library usage information.
โ ์ ์ฅ์ ๋ด ๋ผ์ด๋ธ๋ฌ๋ฆฌ ๋๋ ํ ๋ฆฌ์ ๋ฃจํธ์ ์์นํ๋ฉฐ ํจํค์ง ์ค์น ๋ฐ ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์ฌ์ฉ ์ ๋ณด๋ฅผ ํฌํจํฉ๋๋ค.
=> sentence distance : 70
โ line 13
โ Generated from
โ ์ฝ๋์
=> sentence distance : 14
โ line 13
โ docstrings in your code; published on docs.microsoft.com.
โ docstrings์์ ์์ฑ๋๋ฉฐ docs.microsoft.com์ ๊ฒ์๋ฉ๋๋ค.
=> sentence distance : 33
โ line 14
โ Short code examples that demonstrate single (atomic) operations for the champion scenarios you've identified for your library; included in your
โ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์์ ์๋ณํ ์๋๋ฆฌ์ค์ ๋ํ ๋จ์ผ(์์) ์ฐ์ฐ์ ๋ณด์ฌ์ฃผ๋ ๊ฐ๋จํ ์ฝ๋ ์์ ๋๋ค. ์ด๋
=> sentence distance : 132
โ line 14
โ Quickstart.
โ Quickstart ์ ์ฌ์ฉ๋ฉ๋๋ค.
=> sentence distance : 8
โ line 15
โ Article on
โ README ์ ์ ์ฌํ์ง๋ง ํ์ฅ๋๋
=> sentence distance : 17
โ line 15
โ that is similar to but expands on the README content; typically written by your service's content developer.
โ ๊ด๋ จ ๊ธฐ์ฌ์ ๋๋ค. ์ผ๋ฐ์ ์ผ๋ก ์๋น์ค ์ฝํ ์ธ ๊ฐ๋ฐ์๊ฐ ์์ฑํฉ๋๋ค.
=> sentence distance : 101
โ line 16
โ Tutorials, How-to guides, and other content on docs.microsoft.com; typically written by your service's content developer.
โ ํํ ๋ฆฌ์ผ, ์ฌ์ฉ ๋ฐฉ๋ฒ ์๋ด์ ๋ฐ ๊ธฐํ ์ปจํ ์ธ ์ ๊ฐ์ ๊ธด ํ์์ ์ค๋ช ์์ ๋๋ค. ์ผ๋ฐ์ ์ผ๋ก ์๋น์ค ์ฝํ ์ธ ๊ฐ๋ฐ์๊ฐ ์์ฑํฉ๋๋ค.
=> sentence distance : 106
โ line 18
โ include your service's content developer in the adparch review for your library. To find the content developer you should work with, check with your team's Program Manager.
โ ์๋น์ค์ ์ฝํ ์ธ ๊ฐ๋ฐ์๋ฅผ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ๋ํ ์์ ๋ณด๊ด์ ๋ฆฌ๋ทฐ์ด๋ก ํฌํจํ์์ค. ํจ๊ป ์์ ํด์ผ ํ ์ฝํ ์ธ ๊ฐ๋ฐ์๋ฅผ ์ฐพ์ผ๋ ค๋ฉด ํ์ ํ๋ก๊ทธ๋จ ๊ด๋ฆฌ์์๊ฒ ๋ฌธ์ํ์ญ์์ค.
=> sentence distance : 152
โ line 20
โ Guide].
โ ์๋ด์] ์ ๋ฐ๋ฅด์์ค.
=> sentence distance : 11
โ line 20
โ follow the
โ None
=> sentence distance : None
โ line 22
โ adhere to the specifications set forth in the
โ ๊ณต๊ฐ ๋ฌธ์๋ฅผ ์์ฑํ ๋
=> sentence distance : 42
โ line 22
โ style guides when you write public-facing documentation. This applies to both long-form documentation like a README and the
โ ์คํ์ผ ์๋ด์์ ๋ช ์๋ ์ฌ์์ ์ค์ํ์ญ์์ค. ์ด๋ README์ ๊ฐ์ ๊ธด ์์ ์ค๋ช ์์ ์ฝ๋์
=> sentence distance : 111
โ line 22
โ in your code. (MICROSOFT INTERNAL)
โ ๋ชจ๋์ ์ ์ฉ๋ฉ๋๋ค(MICROFT INTERNAL).
=> sentence distance : 16
โ line 24
โ Writing Style Guide].
โ ์์ฑ ์คํ์ผ ์๋ด์].
=> sentence distance : 17
โ line 25
โ Cloud Style Guide].
โ ํด๋ผ์ฐ๋ ์คํ์ผ ์๋ด์].
=> sentence distance : 15
โ line 27
โ attempt to document your library into silence. Preempt developers' usage questions and minimize
โ ๋น์ ์ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ์นจ๋ฌต์ผ๋ก ๋ง๋ค๋ ค๋ ์๋๋ฅผ ํฉ๋๋ค. ๋ฌธ์ ๋ฌธ์์ด์ API๋ฅผ ๋ช ํํ๊ฒ ์ค๋ช ํ์ฌ ๊ฐ๋ฐ์์ ์ฌ์ฉ ์ง๋ฌธ์ ์ฌ์ ์ ์ฐจ๋จํ๊ณ
=> sentence distance : 83
โ line 27
โ issues by clearly explaining your API in the docstrings. Include information on service limits and errors they might hit, and how to avoid and recover from those errors.
โ ๋ฌธ์ ๋ฅผ ์ต์ํํฉ๋๋ค. ์๋น์ค ์ ํ ๋ฐ ์ด๋ฌํ ์ค๋ฅ๊ฐ ๋ฐ์ํ ์ ์๋ ์ค๋ฅ, ์ด๋ฌํ ์ค๋ฅ๋ฅผ ๋ฐฉ์งํ๊ณ ๋ณต๊ตฌํ๋ ๋ฐฉ๋ฒ์ ๋ํ ์ ๋ณด๋ฅผ ํฌํจํฉ๋๋ค.
=> sentence distance : 149
โ line 29
โ As you write your code, *doc it so you never hear about it again.* The less questions you have to answer about your client library, the more time you have to build new features for your service.
โ ์ฝ๋๋ฅผ ์์ฑํ๋ฉด์ ๋์ด์ ์ง๋ฌธ์ ๋ฐ์ง ์์ ์ ์๋๋ก ๋ฌธ์ ์์ฑ์ ํ์ธ์. ํด๋ผ์ด์ธํธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ๊ดํ ์ง๋ฌธ์ ๋ ์ ๊ฒ ๋ฐ์ ์๋ก ์๋น์ค๋ฅผ ์ํ ์๋ก์ด ๊ธฐ๋ฅ์ ๊ตฌ์ถํด์ผ ํ๋ ์๊ฐ์ด ๋์ด๋ฉ๋๋ค.
=> sentence distance : 166
โ line 33
โ follow the [documentation guidelines](http://aka.ms/pydocs) unless explicitly overridden in this document.
โ ์ด ๋ฌธ์์์ ๋ช ์์ ์ผ๋ก ์ฌ์ ์๋์ง ์์ ๊ฒฝ์ฐ [๋ฌธ์ ์์ฑ ์๋ด์](http://aka.ms/pydocs) ์ ๋ฐ๋ฅด์ธ์.
=> sentence distance : 78
โ line 35
โ provide docstrings for all public modules, types, and methods.
โ ๋ชจ๋ ๊ณต์ฉ ๋ชจ๋, ์ ํ ๋ฐ ๋ฉ์๋์ ๋ํ docstrings๋ฅผ ์ ๊ณตํฉ๋๋ค.
=> sentence distance : 53
โ line 37
โ document any
โ ๋ฉ์๋์์ ์ง์ ์ ์ผ๋ก ์ฌ์ฉ๋๋ ๋ชจ๋
=> sentence distance : 18
โ line 37
โ directly consumed by a method and add a ref link to
โ ๋ฅผ ๋ฌธ์ํํ๊ณ
=> sentence distance : 50
โ line 37
โ options](https://aka.ms/azsdk/python/options) to provide introduction for shared options. You may refer to the signature of a called method if the
โ options](https://aka.ms/azsdk/python/options)์ ์ฐธ์กฐ ๋งํฌ๋ฅผ ์ถ๊ฐํ์ฌ ๊ณต์ ์ต์ ์ ๋ํ ์๊ฐ๋ฅผ ์ ๊ณตํฉ๋๋ค.
=> sentence distance : 93
โ line 37
โ are passed through.
โ ๊ฐ ์ ๋ฌ๋๋ฉด,ํธ์ถ๋ ๋ฉ์๋์ ์๋ช ์ ์ฐธ์กฐ ํ ์ ์์ต๋๋ค.
=> sentence distance : 29
โ line 39
โ Example:
โ ์์:
=> sentence distance : 7
โ line 53
โ id="python-docstrings-defaults" %} document any default values as part of your docstrings using the format recommended
โ None
=> sentence distance : None
โ line 67
โ that may be raised explicitly in the method and any exceptions raised by the called method.
โ ๋ฉ์๋์์ ๋ช ์์ ์ผ๋ก ์ ๊ธฐ๋ ์ ์๋-] document exceptions [-๋ฐ ํธ์ถ๋ ๋ฐฉ๋ฒ์ ์ํด ์ ๊ธฐ๋๋ ์์ธ์ ๋๋ค.
=> sentence distance : 70
โ line 67
โ None
โ ๋ฉ์๋์์ ๋ช ์์ ์ผ๋ก ์ ๊ธฐ๋ ์ ์๋
=> sentence distance : None
โ line 71
โ include example code snippets alongside your library's code within the repository. The snippets should clearly and succinctly demonstrate the operations most developers need to perform with your library. Include snippets for every common operation, and especially for those that are complex or might otherwise be difficult for new users of your library. At a bare minimum, include snippets for the champion scenarios you've identified for the library.
โ ์์ ์ฝ๋ ์ค๋ํซ์ ์ ์ฅ์ ๋ด์ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ์ฝ๋์ ํจ๊ป ํฌํจํฉ๋๋ค. ์ด๋ฌํ ์ฝ๋ ์ค๋ํซ์ ๋๋ถ๋ถ์ ๊ฐ๋ฐ์๊ฐ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์์ ์ํํด์ผ ํ๋ ์์ ์ ๋ช ํํ๊ณ ๊ฐ๊ฒฐํ๊ฒ ๋ณด์ฌ ์ค๋๋ค. ๋ชจ๋ ์ผ๋ฐ ์์ , ํนํ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ์ ์ฌ์ฉ์์๊ฒ ๋ณต์กํ๊ฑฐ๋ ์ด๋ ค์ธ ์ ์๋ ์์ ์ ๋ํ ์ค๋ํซ์ ํฌํจํฉ๋๋ค. ์ต์ํ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ๋ํด ์๋ณํ ์ฑํผ์ธ ์๋๋ฆฌ์ค์ ๋ํ ์ค๋ํซ์ ํฌํจํฉ๋๋ค.
=> sentence distance : 401
โ line 73
โ build and test your example code snippets using the repository's continuous integration (CI) to ensure they remain functional.
โ ์ ์ฅ์์ CI(Continuous Integration)๋ฅผ ์ฌ์ฉํ์ฌ ์์ ์ฝ๋ ์กฐ๊ฐ์ ๋น๋ํ๊ณ ํ ์คํธํ์ฌ ์ ๋๋ก ์๋ํ๋์ง ํ์ธํฉ๋๋ค.
=> sentence distance : 104
โ line 75
โ include the example code snippets in your library's docstrings so they appear in its
โ ์์ ์ฝ๋ ์ค๋ํซ์ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ๋ฌธ์ ๋ฌธ์์ด์ ํฌํจ์์ผ ํด๋น ๋ฌธ์์ด์ด
=> sentence distance : 76
โ line 75
โ reference. If the language and its tools support it, ingest these snippets directly into the
โ ์ฐธ์กฐ์ ๋ํ๋๋๋ก ํฉ๋๋ค. ์ธ์ด์ ํด๋น ๋๊ตฌ๊ฐ ์ง์ํ๋ ๊ฒฝ์ฐ ์ด๋ฌํ ์ฝ๋ ์ค๋ํซ์ ๋ฌธ์ ๋ฌธ์์ด ๋ด์์
=> sentence distance : 79
โ line 75
โ reference from within the docstrings. Each sample should be a valid `pytest`.
โ ์ฐธ์กฐ๋ก ์ง์ ์์งํฉ๋๋ค. ๊ฐ ์ํ์ ์ ํจํ `pytest`์ฌ์ผ ํฉ๋๋ค.
=> sentence distance : 67
โ line 77
โ Use the
โ ํ์ด์ฌ docstrings์
=> sentence distance : 13
โ line 77
โ directive in Python docstrings to instruct Sphinx to [ingest the snippets automatically][1].
โ ์ง์์ด๋ฅผ ์ฌ์ฉํ์ฌ Sphinx๊ฐ [์๋์ผ๋ก ์ค๋ํซ์ ์์งํ๋๋ก ์ง์ํ์ญ์์ค][1].
=> sentence distance : 75
โ line 79
โ combine more than one operation in a code snippet unless it's required for demonstrating the type or member, or it's *in addition to* existing snippets that demonstrate atomic operations. For example, a
โ ์ ํ์ด๋ ๋ฉค๋ฒ๋ฅผ ์์ฐํ๋ ๋ฐ ํ์ํ๊ฒ ์๋๊ฑฐ๋ ์์ ์ฐ์ฐ์ ์์ฐํ๋๊ฒ ์๋๋ผ๋ฉด ์ฝ๋ ์ค๋ํซ์ ๋ ์ด์์ ์์ ์ ๊ฒฐํฉํฉ๋๋ค. ์๋ฅผ ๋ค์ด,
=> sentence distance : 183
โ line 79
โ code snippet should not include both account and container creation operations--create two different snippets, one for account creation, and one for container creation.
โ ์ฝ๋ ์ค๋ํซ์ ๊ณ์ ์์ฑ ์์ ๊ณผ ์ปจํ ์ด๋ ์์ฑ ์์ ์ ๋ชจ๋ ํฌํจํด์๋ ์๋ฉ๋๋ค. ๋ ๊ฐ์ ๋ค๋ฅธ ์ค๋ํซ์ผ๋ก, ํ๋๋ ๊ณ์ ์์ฑ์ฉ, ๋ค๋ฅธ ํ๋๋ ์ปจํ ์ด๋ ์์ฑ์ฉ์ผ๋ก ์์ฑํฉ๋๋ค.
=> sentence distance : 145
โ line 81
โ Combined operations cause unnecessary friction for a library consumer by requiring knowledge of additional operations which might be outside their current focus. It requires them to first understand the tangential code surrounding the operation they're working on, then carefully extract just the code they need for their task. The developer can no longer simply copy and paste the code snippet into their project.
โ ๊ฒฐํฉ๋ ์์ ์ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์ฌ์ฉ์์๊ฒ ํ์ฌ ์ด์ ์ ๋ฒ์ด๋ ์ ์๋ ์ถ๊ฐ ์์ ์ ๋ํ ์ง์์ ์๊ตฌํ์ฌ ์ด๋ ค์์ ์ค ์ ์์ต๋๋ค. ๋จผ์ ์์ ์ค์ธ ์์ ๊ณผ ๊ด๋ จ๋ ์ฝ๋๋ฅผ ํ์ ํ ๋ค์, ์์ ์ ํ์ํ ์ฝ๋๋ง ์ ์คํ๊ฒ ์ถ์ถํด์ผ ํฉ๋๋ค. ๊ฐ๋ฐ์๋ ๋ ์ด์ ์ฝ๋ ์ค๋ํซ๋ง ๋ณต์ฌํ์ฌ ํ๋ก์ ํธ์ ๋ถ์ฌ๋ฃ์ ์ ์์ต๋๋ค.
=> sentence distance : 369
601 words added. 438 words deleted.
Added words rate 97.72357723577237% (601 / 615 words)
Deleted words rate 71.21951219512195% (438 / 615 words)
-
implementation.md : File Modified +1 / -1 ๐ 2704
โ line 107
โ interchangeable
โ interchangable
=> sentence distance : 1
1 words added. 1 words deleted.
Added words rate 0.03698224852071006% (1 / 2704 words)
Deleted words rate 0.03698224852071006% (1 / 2704 words)
-
-
tables
-
registered_namespaces.md : File Modified +65 / -43 ๐ 176
โ line 2
โ "Registered Namespaces"
โ "๋ฑ๋ก๋ ๋ค์์คํ์ด์ค ๋ชฉ๋ก"
=> sentence distance : 20
โ line 8
โ The following are a list of registered namespaces.
โ ๋ค์์ ๋ฑ๋ก๋ ๋ค์์คํ์ด์ค ๋ชฉ๋ก์ ๋๋ค.
=> sentence distance : 46
โ line 10
โ Namespace
โ ๋ค์์คํ์ด์ค
=> sentence distance : 9
โ line 10
โ Service Owner
โ ์๋น์ค ์์ ์
=> sentence distance : 12
โ line 25
โ We represent the namespace in a standard form (each element is all lower case and starts with the
โ ์ฐ๋ฆฌ๋ ํ์ค ํ์์ผ๋ก ๋ค์์คํ์ด์ค๋ฅผ ๋ํ๋ ๋๋ค(๊ฐ ์์๋ ๋ชจ๋ ์๋ฌธ์์ด๋ฉฐ
=> sentence distance : 89
โ line 25
โ identifier). This standard form must be turned into the language-specific form before use. For example, `azure.security.keyvault` is represented as:
โ ์๋ณ์๋ก ์์ํฉ๋๋ค). ์ฌ์ฉํ๊ธฐ ์ ์ ์ด ํ์ค ์์์ ์ธ์ด๋ณ ํ์์ผ๋ก ๋ณ๊ฒฝํด์ผ ํฉ๋๋ค. ์๋ฅผ ๋ค์ด, `azure.security.keyvault`๋ ๋ค์๊ณผ ๊ฐ์ด ํ์๋ฉ๋๋ค.
=> sentence distance : 108
โ line 27
โ in Java,
โ None
=> sentence distance : None
โ line 27
โ None
โ ์๋ฐ:
=> sentence distance : None
โ line 28
โ in .NET, and
โ None
=> sentence distance : None
โ line 28
โ None
โ .NET:
=> sentence distance : None
โ line 29
โ in C++.
โ None
=> sentence distance : None
โ line 29
โ None
โ C++:
=> sentence distance : None
โ line 31
โ To register a new namespace, contact the
โ ์๋ก์ด ๋ค์์คํ์ด์ค๋ฅผ ๋ฑ๋กํ๋ ค๋ฉด,
=> sentence distance : 38
โ line 31
โ Board].
โ Board]์ ๋ฌธ์ํ์ญ์์ค.
=> sentence distance : 8
65 words added. 43 words deleted.
Added words rate 36.93181818181818% (65 / 176 words)
Deleted words rate 24.431818181818183% (43 / 176 words)
-
-
tracing
-
distributed-tracing-conventions.md : File Added ๐ 187
187 words added.
-
-
typescript
-
approved_dependencies.md : File Added ๐ 101
101 words added. -
design.md : File Added ๐ 5841
5841 words added. -
documentation.md : File Added ๐ 727
727 words added. -
implementation.md : File Added ๐ 4713
4713 words added. -
introduction.md : File Added ๐ 665
665 words added. -
refs.md : File Added ๐ 16
16 words added.
-
-
-
eng
-
README.md : File Modified +19 / -6 ๐ 1049
โ line 13
โ stable
โ GA
=> sentence distance : 6
โ line 14
โ stable.
โ GA.
=> sentence distance : 6
โ line 20
โ unknown,
โ unknown
=> sentence distance : 1
โ line 22
โ - `compat` - This is used to represent a compatibility/bridge library.
โ None
=> sentence distance : None
โ line 27
โ stable release.
โ GA.
=> sentence distance : 14
โ line 28
โ `deprecated`
โ `maintenance`,
=> sentence distance : 10
โ line 28
โ `beta`,
โ None
=> sentence distance : None
โ line 55
โ recommendation
โ recomendation
=> sentence distance : 1
19 words added. 6 words deleted.
Added words rate 1.811248808388942% (19 / 1049 words)
Deleted words rate 0.5719733079122974% (6 / 1049 words)
-
scripts
-
release-template
-
c.md : File Modified +1 / -1 ๐ 116
โ line 11
โ Stable
โ GA
=> sentence distance : 6
1 words added. 1 words deleted.
Added words rate 0.8620689655172413% (1 / 116 words)
Deleted words rate 0.8620689655172413% (1 / 116 words)
-
go.md : File Modified +0 / -83 ๐ 115
โ line 9
โ None
โ #### GA
=> sentence distance : None
โ line 11
โ None
โ - _Add packages_
=> sentence distance : None
โ line 13
โ None
โ #### Updates
=> sentence distance : None
โ line 15
โ None
โ - _Add packages_
=> sentence distance : None
โ line 17
โ None
โ #### Beta
=> sentence distance : None
โ line 19
โ None
โ - _Add packages_
=> sentence distance : None
โ line 21
โ None
โ ## Installation Instructions
=> sentence distance : None
โ line 23
โ None
โ To install any of our modules, copy and paste the following commands into a terminal:
=> sentence distance : None
โ line 25
โ None
โ ```bash
=> sentence distance : None
โ line 26
โ None
โ $>
=> sentence distance : None
โ line 27
โ None
โ ```
=> sentence distance : None
โ line 29
โ None
โ ## Feedback
=> sentence distance : None
โ line 31
โ None
โ If you have a bug or feature request for one of the libraries, please post an issue to [GitHub](https://github.com/Azure/azure-sdk-for-go/issues).
=> sentence distance : None
โ line 33
โ None
โ ## Release highlights
=> sentence distance : None
โ line 35
โ None
โ ### _Package name_
=> sentence distance : None
โ line 37
โ None
โ - Major changes only!
=> sentence distance : None
โ line 39
โ None
โ ## Latest Releases
=> sentence distance : None
โ line 41
โ None
โ View all the latest versions of Go packages [here][go-latest-releases].
=> sentence distance : None
โ line 43
โ None
โ {% include refs.md %}
=> sentence distance : None
0 words added. 83 words deleted.
Added words rate 0.0% (0 / 115 words)
Deleted words rate 72.17391304347827% (83 / 115 words)
-
-
-
-
index.md : File Modified +3 / -6 ๐ 20
โ line 2
โ Releases
โ ํ๊ธ ๋ฌธ์ & ๋ฆฌ์์ค ๋ชจ์
=> sentence distance : 14
โ line 6
โ releases/header.md %}
โ info/header.md
=> sentence distance : 11
3 words added. 6 words deleted.
Added words rate 15.0% (3 / 20 words)
Deleted words rate 30.0% (6 / 20 words)
-
releases
-
2019-07-10
-
2019-07-10-dotnet-preview1.md : File Added ๐ 288
288 words added. -
2019-07-10-java-preview1.md : File Added ๐ 366
366 words added. -
2019-07-10-js-preview1.md : File Added ๐ 264
264 words added. -
2019-07-10-python-preview1.md : File Added ๐ 782
782 words added. -
index.md : File Added ๐ 1188
1188 words added.
-
-
2019-08-06
-
2019-08-06-dotnet-preview2.md : File Added ๐ 446
446 words added. -
2019-08-06-java-preview2.md : File Added ๐ 510
510 words added. -
2019-08-06-js-preview2.md : File Added ๐ 388
388 words added. -
2019-08-06-python-preview2.md : File Added ๐ 317
317 words added. -
index.md : File Added ๐ 941
941 words added.
-
-
2019-09-17
-
2019-09-17-dotnet-preview3.md : File Added ๐ 473
473 words added. -
2019-09-17-java-preview3.md : File Added ๐ 670
670 words added. -
2019-09-17-js-preview3.md : File Added ๐ 289
289 words added. -
2019-09-17-python-preview3.md : File Added ๐ 479
479 words added. -
index.md : File Added ๐ 49
49 words added.
-
-
2019-10-11
-
2019-10-11-dotnet-preview4.md : File Added ๐ 562
562 words added. -
2019-10-11-java-preview4.md : File Added ๐ 657
657 words added. -
2019-10-11-js-preview4.md : File Added ๐ 373
373 words added. -
2019-10-11-python-preview4.md : File Added ๐ 501
501 words added. -
index.md : File Added ๐ 49
49 words added.
-
-
2019-11
-
2019-11-dotnet.md : File Added ๐ 771
771 words added. -
2019-11-java.md : File Added ๐ 789
789 words added. -
2019-11-js.md : File Added ๐ 343
343 words added. -
2019-11-python.md : File Added ๐ 594
594 words added. -
index.md : File Added ๐ 48
48 words added. -
java-quicklinks.md : File Added ๐ 242
242 words added. -
js-quicklinks.md : File Added ๐ 188
188 words added. -
net-quicklinks.md : File Added ๐ 258
258 words added. -
python-quicklinks.md : File Added ๐ 274
274 words added.
-
-
2019-12
-
2019-12-dotnet.md : File Added ๐ 493
493 words added. -
2019-12-java.md : File Added ๐ 750
750 words added. -
2019-12-js.md : File Added ๐ 370
370 words added. -
2019-12-python.md : File Added ๐ 327
327 words added. -
index.md : File Added ๐ 48
48 words added.
-
-
2020-01
-
dotnet.md : File Added ๐ 430
430 words added. -
index.md : File Added ๐ 28
28 words added. -
java.md : File Added ๐ 608
608 words added. -
js.md : File Added ๐ 437
437 words added. -
python.md : File Added ๐ 604
604 words added.
-
-
2020-02
-
dotnet.md : File Added ๐ 462
462 words added. -
index.md : File Added ๐ 28
28 words added. -
java.md : File Added ๐ 552
552 words added. -
js.md : File Added ๐ 467
467 words added. -
python.md : File Added ๐ 341
341 words added.
-
-
2020-03
-
dotnet.md : File Added ๐ 464
464 words added. -
index.md : File Added ๐ 28
28 words added. -
java.md : File Added ๐ 687
687 words added. -
js.md : File Added ๐ 429
429 words added. -
python.md : File Added ๐ 371
371 words added.
-
-
2020-04
-
dotnet.md : File Added ๐ 590
590 words added. -
index.md : File Added ๐ 28
28 words added. -
java.md : File Added ๐ 947
947 words added. -
js.md : File Added ๐ 424
424 words added. -
python.md : File Added ๐ 583
583 words added.
-
-
2020-05
-
dotnet.md : File Added ๐ 436
436 words added. -
index.md : File Added ๐ 28
28 words added. -
java.md : File Added ๐ 754
754 words added. -
js.md : File Added ๐ 441
441 words added. -
python.md : File Added ๐ 542
542 words added.
-
-
2020-06
-
dotnet.md : File Added ๐ 622
622 words added. -
index.md : File Added ๐ 26
26 words added. -
java.md : File Added ๐ 978
978 words added. -
js.md : File Added ๐ 771
771 words added. -
python.md : File Added ๐ 508
508 words added.
-
-
2020-07
-
dotnet.md : File Added ๐ 875
875 words added. -
index.md : File Added ๐ 26
26 words added. -
java.md : File Added ๐ 1257
1257 words added. -
js.md : File Added ๐ 972
972 words added. -
python.md : File Added ๐ 823
823 words added.
-
-
2020-08
-
dotnet.md : File Added ๐ 860
860 words added. -
index.md : File Added ๐ 205
205 words added. -
java.md : File Added ๐ 1756
1756 words added. -
js.md : File Added ๐ 966
966 words added. -
python.md : File Added ๐ 866
866 words added.
-
-
2020-09
-
c.md : File Added ๐ 426
426 words added. -
cpp.md : File Added ๐ 169
169 words added. -
dotnet.md : File Added ๐ 1402
1402 words added. -
index.md : File Added ๐ 207
207 words added. -
java.md : File Added ๐ 1901
1901 words added. -
js.md : File Added ๐ 1213
1213 words added. -
python.md : File Added ๐ 733
733 words added.
-
-
2020-10
-
android.md : File Added ๐ 312
312 words added. -
c.md : File Added ๐ 219
219 words added. -
cpp.md : File Added ๐ 167
167 words added. -
dotnet.md : File Added ๐ 1271
1271 words added. -
index.md : File Added ๐ 242
242 words added. -
ios.md : File Added ๐ 395
395 words added. -
java.md : File Added ๐ 3157
3157 words added. -
js.md : File Added ๐ 750
750 words added. -
python.md : File Added ๐ 773
773 words added.
-
-
2020-11
-
android.md : File Added ๐ 218
218 words added. -
c.md : File Added ๐ 238
238 words added. -
cpp.md : File Added ๐ 641
641 words added. -
dotnet.md : File Added ๐ 2262
2262 words added. -
index.md : File Added ๐ 276
276 words added. -
ios.md : File Added ๐ 772
772 words added. -
java.md : File Added ๐ 2687
2687 words added. -
js.md : File Added ๐ 1630
1630 words added. -
python.md : File Added ๐ 893
893 words added.
-
-
2020-12
-
android.md : File Added ๐ 218
218 words added. -
c.md : File Added ๐ 116
116 words added. -
cpp.md : File Added ๐ 116
116 words added. -
dotnet.md : File Added ๐ 539
539 words added. -
index.md : File Added ๐ 143
143 words added. -
ios.md : File Added ๐ 326
326 words added. -
java.md : File Added ๐ 1467
1467 words added. -
js.md : File Added ๐ 468
468 words added. -
python.md : File Added ๐ 304
304 words added.
-
-
2021-01
-
android.md : File Added ๐ 222
222 words added. -
cpp.md : File Added ๐ 1576
1576 words added. -
dotnet.md : File Added ๐ 726
726 words added. -
index.md : File Added ๐ 261
261 words added. -
ios.md : File Added ๐ 657
657 words added. -
java.md : File Added ๐ 1847
1847 words added. -
js.md : File Added ๐ 480
480 words added. -
python.md : File Added ๐ 504
504 words added.
-
-
2021-02
-
android.md : File Added ๐ 564
564 words added. -
cpp.md : File Added ๐ 626
626 words added. -
dotnet.md : File Added ๐ 1681
1681 words added. -
go.md : File Added ๐ 115
115 words added. -
index.md : File Added ๐ 285
285 words added. -
ios.md : File Added ๐ 857
857 words added. -
java.md : File Added ๐ 2344
2344 words added. -
js.md : File Added ๐ 1565
1565 words added. -
python.md : File Added ๐ 850
850 words added.
-
-
2021-03
-
android.md : File Added ๐ 409
409 words added. -
c.md : File Added ๐ 182
182 words added. -
cpp.md : File Added ๐ 583
583 words added. -
dotnet.md : File Added ๐ 1687
1687 words added. -
go.md : File Added ๐ 115
115 words added. -
index.md : File Added ๐ 320
320 words added. -
ios.md : File Added ๐ 773
773 words added. -
java.md : File Added ๐ 3414
3414 words added. -
js.md : File Added ๐ 1442
1442 words added. -
python.md : File Added ๐ 3702
3702 words added.
-
-
2021-04
-
android.md : File Added ๐ 850
850 words added. -
cpp.md : File Added ๐ 450
450 words added. -
dotnet.md : File Added ๐ 2602
2602 words added. -
go.md : File Added ๐ 115
115 words added. -
index.md : File Added ๐ 202
202 words added. -
ios.md : File Added ๐ 701
701 words added. -
java.md : File Added ๐ 6079
6079 words added. -
js.md : File Added ๐ 3515
3515 words added. -
python.md : File Added ๐ 3557
3557 words added.
-
-
2021-05
-
android.md : File Added ๐ 586
586 words added. -
cpp.md : File Added ๐ 116
116 words added. -
dotnet.md : File Added ๐ 26
26 words added. -
go.md : File Added ๐ 115
115 words added. -
index.md : File Added ๐ 265
265 words added. -
ios.md : File Added ๐ 942
942 words added. -
java.md : File Added ๐ 26
26 words added. -
js.md : File Added ๐ 27
27 words added. -
python.md : File Added ๐ 26
26 words added.
-
-
2021-06
-
android.md : File Added ๐ 26
26 words added. -
cpp.md : File Added ๐ 346
346 words added. -
dotnet.md : File Added ๐ 26
26 words added. -
go.md : File Added ๐ 115
115 words added. -
index.md : File Added ๐ 126
126 words added. -
ios.md : File Added ๐ 799
799 words added. -
java.md : File Added ๐ 26
26 words added. -
js.md : File Added ๐ 27
27 words added. -
python.md : File Added ๐ 26
26 words added.
-
-
2021-07
-
android.md : File Added ๐ 26
26 words added. -
c.md : File Added ๐ 240
240 words added. -
cpp.md : File Added ๐ 26
26 words added. -
dotnet.md : File Added ๐ 26
26 words added. -
go.md : File Added ๐ 115
115 words added. -
index.md : File Added ๐ 129
129 words added. -
ios.md : File Added ๐ 26
26 words added. -
java.md : File Added ๐ 26
26 words added. -
js.md : File Added ๐ 27
27 words added. -
python.md : File Added ๐ 26
26 words added.
-
-
2021-08
-
android.md : File Added ๐ 26
26 words added. -
cpp.md : File Added ๐ 26
26 words added. -
dotnet.md : File Added ๐ 26
26 words added. -
go.md : File Added ๐ 40
40 words added. -
index.md : File Added ๐ 125
125 words added. -
ios.md : File Added ๐ 26
26 words added. -
java.md : File Added ๐ 26
26 words added. -
js.md : File Added ๐ 27
27 words added. -
python.md : File Added ๐ 26
26 words added.
-
-
2021-09
-
android.md : File Added ๐ 26
26 words added. -
c.md : File Added ๐ 290
290 words added. -
cpp.md : File Added ๐ 26
26 words added. -
dotnet.md : File Added ๐ 26
26 words added. -
go.md : File Added ๐ 25
25 words added. -
index.md : File Added ๐ 130
130 words added. -
ios.md : File Added ๐ 26
26 words added. -
java.md : File Added ๐ 26
26 words added. -
js.md : File Added ๐ 27
27 words added. -
python.md : File Added ๐ 26
26 words added.
-
-
2021-10
-
android.md : File Added ๐ 26
26 words added. -
c.md : File Added ๐ 36
36 words added. -
cpp.md : File Added ๐ 26
26 words added. -
dotnet.md : File Added ๐ 26
26 words added. -
go.md : File Added ๐ 40
40 words added. -
index.md : File Added ๐ 130
130 words added. -
ios.md : File Added ๐ 26
26 words added. -
java.md : File Added ๐ 26
26 words added. -
js.md : File Added ๐ 27
27 words added. -
python.md : File Added ๐ 26
26 words added.
-
-
2021-11
-
android.md : File Added ๐ 26
26 words added. -
c.md : File Added ๐ 155
155 words added. -
cpp.md : File Added ๐ 26
26 words added. -
dotnet.md : File Added ๐ 26
26 words added. -
go.md : File Added ๐ 40
40 words added. -
index.md : File Added ๐ 130
130 words added. -
ios.md : File Added ๐ 26
26 words added. -
java.md : File Added ๐ 26
26 words added. -
js.md : File Added ๐ 27
27 words added. -
python.md : File Added ๐ 26
26 words added.
-
-
2021-12
-
android.md : File Added ๐ 26
26 words added. -
c.md : File Added ๐ 39
39 words added. -
cpp.md : File Added ๐ 26
26 words added. -
dotnet.md : File Added ๐ 26
26 words added. -
go.md : File Added ๐ 40
40 words added. -
index.md : File Added ๐ 116
116 words added. -
ios.md : File Added ๐ 26
26 words added. -
java.md : File Added ๐ 26
26 words added. -
js.md : File Added ๐ 27
27 words added. -
python.md : File Added ๐ 26
26 words added.
-
-
2022-01
-
android.md : File Added ๐ 26
26 words added. -
c.md : File Added ๐ 39
39 words added. -
cpp.md : File Added ๐ 26
26 words added. -
dotnet.md : File Added ๐ 26
26 words added. -
go.md : File Added ๐ 40
40 words added. -
index.md : File Added ๐ 129
129 words added. -
ios.md : File Added ๐ 26
26 words added. -
java.md : File Added ๐ 26
26 words added. -
js.md : File Added ๐ 27
27 words added. -
python.md : File Added ๐ 26
26 words added.
-
-
2022-02
-
android.md : File Added ๐ 26
26 words added. -
c.md : File Added ๐ 241
241 words added. -
cpp.md : File Added ๐ 26
26 words added. -
dotnet.md : File Added ๐ 26
26 words added. -
go.md : File Added ๐ 40
40 words added. -
index.md : File Added ๐ 129
129 words added. -
ios.md : File Added ๐ 26
26 words added. -
java.md : File Added ๐ 26
26 words added. -
js.md : File Added ๐ 27
27 words added. -
python.md : File Added ๐ 26
26 words added.
-
-
2022-03
-
android.md : File Added ๐ 26
26 words added. -
c.md : File Added ๐ 39
39 words added. -
cpp.md : File Added ๐ 26
26 words added. -
dotnet.md : File Added ๐ 26
26 words added. -
go.md : File Added ๐ 40
40 words added. -
index.md : File Added ๐ 129
129 words added. -
ios.md : File Added ๐ 26
26 words added. -
java.md : File Added ๐ 26
26 words added. -
js.md : File Added ๐ 27
27 words added. -
python.md : File Added ๐ 26
26 words added.
-
-
2022-04
-
android.md : File Added ๐ 26
26 words added. -
c.md : File Added ๐ 137
137 words added. -
cpp.md : File Added ๐ 26
26 words added. -
dotnet.md : File Added ๐ 26
26 words added. -
go.md : File Added ๐ 40
40 words added. -
index.md : File Added ๐ 129
129 words added. -
ios.md : File Added ๐ 26
26 words added. -
java.md : File Added ๐ 26
26 words added. -
js.md : File Added ๐ 27
27 words added. -
python.md : File Added ๐ 26
26 words added.
-
-
2022-05
-
android.md : File Added ๐ 26
26 words added. -
c.md : File Added ๐ 116
116 words added. -
cpp.md : File Added ๐ 26
26 words added. -
dotnet.md : File Added ๐ 26
26 words added. -
go.md : File Added ๐ 40
40 words added. -
index.md : File Added ๐ 129
129 words added. -
ios.md : File Added ๐ 26
26 words added. -
java.md : File Added ๐ 26
26 words added. -
js.md : File Added ๐ 27
27 words added. -
python.md : File Added ๐ 26
26 words added.
-
-
2022-06
-
android.md : File Added ๐ 26
26 words added. -
c.md : File Added ๐ 116
116 words added. -
cpp.md : File Added ๐ 26
26 words added. -
dotnet.md : File Added ๐ 26
26 words added. -
go.md : File Added ๐ 40
40 words added. -
index.md : File Added ๐ 116
116 words added. -
ios.md : File Added ๐ 26
26 words added. -
java.md : File Added ๐ 26
26 words added. -
js.md : File Added ๐ 27
27 words added. -
python.md : File Added ๐ 26
26 words added.
-
-
deprecated
-
dotnet.md : File Added ๐ 25
25 words added. -
go.md : File Added ๐ 25
25 words added. -
index.md : File Added ๐ 45
45 words added. -
java.md : File Added ๐ 25
25 words added. -
js.md : File Added ๐ 26
26 words added. -
python.md : File Added ๐ 25
25 words added.
-
-
latest
-
all
-
dotnet.md : File Modified +2 / -1 ๐ 46
โ line 9
โ NuGet
โ nuget
=> sentence distance : 2
โ line 9
โ SDK
โ None
=> sentence distance : None
2 words added. 1 words deleted.
Added words rate 4.3478260869565215% (2 / 46 words)
Deleted words rate 2.1739130434782608% (1 / 46 words)
-
index.md : File Modified +1 / -0 ๐ 26
โ line 8
โ type=all
โ None
=> sentence distance : None
1 words added. 0 words deleted.
Added words rate 3.8461538461538463% (1 / 26 words)
Deleted words rate 0.0% (0 / 26 words)
-
java.md : File Modified +1 / -0 ๐ 47
โ line 9
โ SDK
โ None
=> sentence distance : None
1 words added. 0 words deleted.
Added words rate 2.127659574468085% (1 / 47 words)
Deleted words rate 0.0% (0 / 47 words)
-
js.md : File Modified +1 / -0 ๐ 47
โ line 9
โ SDK
โ None
=> sentence distance : None
1 words added. 0 words deleted.
Added words rate 2.127659574468085% (1 / 47 words)
Deleted words rate 0.0% (0 / 47 words)
-
python.md : File Modified +1 / -0 ๐ 46
โ line 9
โ SDK
โ None
=> sentence distance : None
1 words added. 0 words deleted.
Added words rate 2.1739130434782608% (1 / 46 words)
Deleted words rate 0.0% (0 / 46 words)
-
-
index.md : File Modified +1 / -0 ๐ 28
โ line 9
โ type=client
โ None
=> sentence distance : None
1 words added. 0 words deleted.
Added words rate 3.571428571428571% (1 / 28 words)
Deleted words rate 0.0% (0 / 28 words)
-
mgmt
-
index.md : File Modified +1 / -0 ๐ 26
โ line 8
โ type=mgmt
โ None
=> sentence distance : None
1 words added. 0 words deleted.
Added words rate 3.8461538461538463% (1 / 26 words)
Deleted words rate 0.0% (0 / 26 words)
-
-
-
repository change statistics
> Details
Comitted change with repo : โI18N-FOR-BEGINNERSโ
- โ..โ dir : 30 words added. 30 words deleted.
- โAโ dir : 30 words added. 29 words deleted.
- โBโ dir : 30 words added. 28 words deleted.
- โCโ dir : 40 words added. 20 words deleted.
as total, 3000 words added. 1200 words deleted.
โmainโ branch on โI18Nโ repo ( updated ) has 90000 words.
โmainโ branch on โI18N-FOR-BEGINNERSโ repo ( had been updated on 2022-05-20 ) has 89000 words.
Approximately 9000 words need to be translated added.Added words(need te be translated) rate 98.5% ( 89000 / 90000 words )