-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathversion_guarantees.html
173 lines (163 loc) · 8.05 KB
/
version_guarantees.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>버전 개런티</title>
<!-- end extra head -->
<link href="https://fonts.googleapis.com/icon?family=Material+Icons" rel="stylesheet">
<link rel="stylesheet" href="_static/style.css" type="text/css" />
<link rel="stylesheet" href="_static/codeblocks.css" type="text/css" />
<link rel="stylesheet" href="_static/icons.css" type="text/css" />
<script id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script src="_static/jquery.js"></script>
<script src="_static/underscore.js"></script>
<script src="_static/doctools.js"></script>
<script src="_static/language_data.js"></script>
<script src="_static/custom.js"></script>
<script src="_static/settings.js"></script>
<script src="_static/copy.js"></script>
<script src="_static/sidebar.js"></script>
<script src="_static/translations.js"></script>
<link rel="shortcut icon" href="_static/discord_py_logo.ico"/>
<link rel="index" title="색인" href="genindex.html" />
<link rel="search" title="검색" href="search.html" />
<link rel="next" title="1.0 버전으로 이전하기" href="migrating.html" />
<link rel="prev" title="바뀐 것에 대한 기록" href="whats_new.html" />
</head>
<body>
<div class="main-grid">
<header class="grid-item">
<nav>
<a href="index.html" class="main-heading">discord.py</a>
<a href="https://github.com/Rapptz/discord.py" title="GitHub"><span class="material-icons custom-icons">github</span></a>
<a href="https://discord.gg/YbfbxpX" title="Discord"><span class="material-icons custom-icons">discord</span></a>
<a href="faq.html" title="FAQ"><span class="material-icons">help_center</span></a>
<a onclick="mobileSearch.open();" title="검색" id="open-search" class="mobile-only"><span class="material-icons">search</span></a>
<a onclick="mobileSearch.close();" title="Close" id="close-search" class="mobile-only" hidden><span class="material-icons">close</span></a>
</nav>
<nav class="mobile-only">
<form role="search" class="search" action="search.html" method="get">
<div class="search-wrapper">
<input type="search" name="q" placeholder="Search documentation" />
<button type="submit">
<span class="material-icons">search</span>
</button>
</div>
</form>
</nav>
</header>
<div class="sub-header grid-item">
<label for="documentation_select">View Documentation For</label>
<select id="documentation_select" onchange="window.location = this.value;">
<option value="#" selected>discord</option>
<option value="ext/commands/index.html" >discord.ext.commands</option>
<option value="ext/tasks/index.html" >discord.ext.tasks</option>
</select>
<form role="search" class="search" action="search.html" method="get">
<div class="search-wrapper">
<input type="search" name="q" placeholder="Search documentation" />
<button type="submit">
<span class="material-icons">search</span>
</button>
</div>
</form>
<a accesskey="S" class="settings" onclick="settingsModal.open();"><span class="material-icons">settings</span></a>
</div>
<aside class="grid-item">
<span id="hamburger-toggle">
<span class="material-icons">menu</span>
</span>
<span id="settings-toggle" class="settings" onclick="settingsModal.open();">
<span class="material-icons">settings</span>
</span>
<div id="sidebar">
<h3><a href="index.html">목차</a></h3>
<ul>
<li><a class="reference internal" href="#">버전 개런티</a><ul>
<li><a class="reference internal" href="#examples-of-breaking-changes">큰 변화의 예</a></li>
<li><a class="reference internal" href="#examples-of-non-breaking-changes">큰 변화가 아닌 것의 예</a></li>
</ul>
</li>
</ul>
</div>
</aside>
<main class="grid-item" role="main">
<section id="version-guarantees">
<span id="id1"></span><h1>버전 개런티<a class="headerlink" href="#version-guarantees" title="제목 주소">¶</a></h1>
<p>라이브러리는 <a class="reference external" href="https://semver.org/">유의적 버전화 원리</a> 를 따릅니다. 이는 주요 버전이 업데이트될 때마다 호환되지 않는 API 변경이 발생한다는 뜻입니다. 그러나 Python의 상당히 역동적인 성격과 달리 디스코드의 부족한 개런티로는 무엇이 큰 변화이고 아닌지를 분별하기는 어려울 수 있습니다.</p>
<p>첫 번째로 알아두어야 할 것은 큰 변화는 <strong>공개적으로 작성된 함수와 클래스</strong> 에만 적용된다는 점입니다. 만약 이 문서에 등록되지 않았다면 그것은 공개 API의 일부가 아니므로 변경되어야 합니다. 문서에 작성되지 않은 밑줄로 시작하는 속성 또는 밑줄로 시작하지 않는 함수가 여기에 포함됩니다.</p>
<div class="admonition note">
<p class="admonition-title">참고</p>
<p>아래의 예시들은 포괄적이지 않습니다.</p>
</div>
<section id="examples-of-breaking-changes">
<h2>큰 변화의 예<a class="headerlink" href="#examples-of-breaking-changes" title="제목 주소">¶</a></h2>
<ul class="simple">
<li><p>기본 매개 변수 값을 다른 것으로 바꾸는 것.</p></li>
<li><p>기존 함수를 별칭으로 두지 않고 함수의 이름을 바꾸는 것.</p></li>
<li><p>이벤트에 매개 변수 추가 또는 삭제.</p></li>
</ul>
</section>
<section id="examples-of-non-breaking-changes">
<h2>큰 변화가 아닌 것의 예<a class="headerlink" href="#examples-of-non-breaking-changes" title="제목 주소">¶</a></h2>
<ul class="simple">
<li><p>비공개 밑줄 속성의 추가 또는 제거.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">__slots__</span></code> 의 데이터 클래스에 요소 추가.</p></li>
<li><p>버그를 해결하기 위한 함수의 작동 방식 변경.</p></li>
<li><p>문서의 변경.</p></li>
<li><p>내부적인 HTTP 처리 수정.</p></li>
<li><p>주 버전 또는 다른 새로운 버전으로의 의존성 업그레이드.</p></li>
</ul>
</section>
</section>
</main>
<footer class="grid-item">
© Copyright 2015-2020, Rapptz.
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 3.2.1.
</footer>
</div>
<div id="settings" class="modal" onclick="if (event.target == this){ settingsModal.close(); }" hidden>
<div class="modal-content">
<span class="close" onclick="settingsModal.close();" title="Close">
<span class="material-icons">close</span>
</span>
<h1>Settings</h1>
<h2>Font</h2>
<div class="setting">
<h3>Use a serif font:
<label class="toggle"
title="Use a serif font? Your system font will be used, falling back to serif.">
<input type="checkbox" name="useSerifFont" onclick="updateSetting(this);">
<span class="toggle-slider"></span>
</label>
</h3>
</div>
<h2>Theme</h2>
<div class="setting">
<h3>
<label class="toggle" title="Set your theme based on your system preferences">
<input type="radio" name="setTheme" onclick="updateSetting(this);" value="automatic" checked>
</label>
Automatic
</h3>
<h3>
<label class="toggle" title="Set your theme to light theme">
<input type="radio" name="setTheme" onclick="updateSetting(this);" value="light">
</label>
Light
</h3>
<h3>
<label class="toggle" title="Set your theme to dark theme">
<input type="radio" name="setTheme" onclick="updateSetting(this);" value="dark">
</label>
Dark
</h3>
</div>
</div>
</div>
<div id="to-top" onclick="scrollToTop()" hidden>
<span><span class="material-icons">arrow_upward</span> to top</span>
</div>
</body>
</html>