docs: add cherrypick/apply/tracing/attributes/reflog/submodule docs

docs/gen/translate.ts

@@ -23,6 +23,7 @@ If translating in Korean, translate "Git Object" as "Git 개체".
 If translating in Korean, translate "Tree" as "트리".
 If translating in Korean, translate "Repository" as "리포지토리".
 If translating in Japanese, finish the sentence in ます style.
+Don't translate signature/example codes (except comments) or parameters name.
 Finish with a noun if it is a explanation for a parameter or a return value.
 
 ===
@@ -32,7 +33,7 @@ ${JSON.stringify(doc, null, 2)}
   `;
 
   const response = await ai.chat.completions.create({
-    model: options?.model ?? 'gpt-4o',
+    model: options?.model ?? 'gpt-5.2',
     messages: [{ role: 'user', content: prompt }],
   });
 

docs/ko/reference/Reflog/Methods/append.md

@@ -0,0 +1,58 @@
+# append
+
+reflog에 새 항목을 추가해요.
+
+## 시그니처
+
+```ts
+class Reflog {
+  append(newOid: string, committer: Signature, msg?: string | null | undefined): void;
+}
+```
+
+### 파라미터
+
+<ul class="param-ul">
+  <li class="param-li param-li-root">
+    <span class="param-name">newOid</span><span class="param-required">필수</span>&nbsp;·&nbsp;<span class="param-type">string</span>
+    <br>
+    <p class="param-description">이 reflog 항목의 새 개체 ID(SHA1)</p>
+  </li>
+  <li class="param-li param-li-root">
+    <span class="param-name">committer</span><span class="param-required">필수</span>&nbsp;·&nbsp;<span class="param-type">Signature</span>
+    <br>
+    <p class="param-description">이 reflog 항목의 커미터 서명</p>
+    <ul class="param-ul">
+      <li class="param-li">
+        <span class="param-name">email</span><span class="param-required">필수</span>&nbsp;·&nbsp;<span class="param-type">string</span>
+        <br>
+        <p class="param-description">서명에 포함된 이메일</p>
+      </li>
+      <li class="param-li">
+        <span class="param-name">name</span><span class="param-required">필수</span>&nbsp;·&nbsp;<span class="param-type">string</span>
+        <br>
+        <p class="param-description">서명에 포함된 이름</p>
+      </li>
+      <li class="param-li">
+        <span class="param-name">timestamp</span><span class="param-required">필수</span>&nbsp;·&nbsp;<span class="param-type">number</span>
+        <br>
+        <p class="param-description">에포크로부터의 초 단위 시간</p>
+      </li>
+    </ul>
+  </li>
+  <li class="param-li param-li-root">
+    <span class="param-name">msg</span><span class="param-type">null | string</span>
+    <br>
+    <p class="param-description">이 reflog 항목의 선택적 메시지</p>
+  </li>
+</ul>
+
+### 에러
+
+<ul class="param-ul">
+  <li class="param-li param-li-root">
+    <span class="param-type">Error</span>
+    <br>
+    <p class="param-description">OID가 유효하지 않거나 추가에 실패하면 오류를 던져요.</p>
+  </li>
+</ul>

docs/ko/reference/Reflog/Methods/get.md

@@ -0,0 +1,31 @@
+# get
+
+인덱스로 reflog 항목을 가져와요.
+
+## 시그니처
+
+```ts
+class Reflog {
+  get(i: number): ReflogEntry | null;
+}
+```
+
+### 파라미터
+
+<ul class="param-ul">
+  <li class="param-li param-li-root">
+    <span class="param-name">i</span><span class="param-required">필수</span>&nbsp;·&nbsp;<span class="param-type">number</span>
+    <br>
+    <p class="param-description">가져올 항목의 인덱스</p>
+  </li>
+</ul>
+
+### 반환 값
+
+<ul class="param-ul">
+  <li class="param-li param-li-root">
+    <span class="param-type">null | ReflogEntry</span>
+    <br>
+    <p class="param-description">지정한 인덱스의 reflog 항목이에요. 인덱스가 범위를 벗어나면 <code>null</code>을 반환해요.</p>
+  </li>
+</ul>

docs/ko/reference/Reflog/Methods/isEmpty.md

@@ -0,0 +1,21 @@
+# isEmpty
+
+reflog가 비어 있는지 확인해요.
+
+## 시그니처
+
+```ts
+class Reflog {
+  isEmpty(): boolean;
+}
+```
+
+### 반환 값
+
+<ul class="param-ul">
+  <li class="param-li param-li-root">
+    <span class="param-type">boolean</span>
+    <br>
+    <p class="param-description">reflog가 비어 있으면 <code>true</code>, 그렇지 않으면 <code>false</code>인 값</p>
+  </li>
+</ul>

docs/ko/reference/Reflog/Methods/iter.md

@@ -0,0 +1,31 @@
+# iter
+
+reflog 항목에 대한 이터레이터를 만들어요.
+
+## 시그니처
+
+```ts
+class Reflog {
+  iter(): ReflogIter;
+}
+```
+
+### 반환 값
+
+<ul class="param-ul">
+  <li class="param-li param-li-root">
+    <span class="param-type">ReflogIter</span>
+    <br>
+    <p class="param-description">reflog 항목에 대한 이터레이터</p>
+  </li>
+</ul>
+
+### 에러
+
+<ul class="param-ul">
+  <li class="param-li param-li-root">
+    <span class="param-type">Error</span>
+    <br>
+    <p class="param-description">reflog에 접근할 수 없으면 오류를 던져요.</p>
+  </li>
+</ul>

docs/ko/reference/Reflog/Methods/len.md

@@ -0,0 +1,21 @@
+# len
+
+reflog의 항목 수를 가져와요.
+
+## 시그니처
+
+```ts
+class Reflog {
+  len(): number;
+}
+```
+
+### 반환 값
+
+<ul class="param-ul">
+  <li class="param-li param-li-root">
+    <span class="param-type">number</span>
+    <br>
+    <p class="param-description">reflog의 항목 수</p>
+  </li>
+</ul>

docs/ko/reference/Reflog/Methods/remove.md

@@ -0,0 +1,36 @@
+# remove
+
+reflog에서 항목을 제거해요.
+
+## 시그니처
+
+```ts
+class Reflog {
+  remove(i: number, rewritePreviousEntry?: boolean): void;
+}
+```
+
+### 파라미터
+
+<ul class="param-ul">
+  <li class="param-li param-li-root">
+    <span class="param-name">i</span><span class="param-required">필수</span>&nbsp;·&nbsp;<span class="param-type">number</span>
+    <br>
+    <p class="param-description">제거할 항목의 인덱스</p>
+  </li>
+  <li class="param-li param-li-root">
+    <span class="param-name">rewritePreviousEntry</span><span class="param-type">null | boolean</span>
+    <br>
+    <p class="param-description">이전 항목을 다시 쓸지 여부예요. 기본값은 <code>false</code>예요.</p>
+  </li>
+</ul>
+
+### 에러
+
+<ul class="param-ul">
+  <li class="param-li param-li-root">
+    <span class="param-type">Error</span>
+    <br>
+    <p class="param-description">인덱스가 유효하지 않거나 제거에 실패하면 오류를 던져요.</p>
+  </li>
+</ul>

docs/ko/reference/Reflog/Methods/write.md

@@ -0,0 +1,21 @@
+# write
+
+reflog를 디스크에 써요.
+
+## 시그니처
+
+```ts
+class Reflog {
+  write(): void;
+}
+```
+
+### 에러
+
+<ul class="param-ul">
+  <li class="param-li param-li-root">
+    <span class="param-type">Error</span>
+    <br>
+    <p class="param-description">쓰기 실패 시 오류를 던져요.</p>
+  </li>
+</ul>

docs/ko/reference/ReflogEntry/Methods/committer.md

@@ -0,0 +1,38 @@
+# committer
+
+이 reflog 항목의 커미터를 가져와요.
+
+## 시그니처
+
+```ts
+class ReflogEntry {
+  committer(): Signature;
+}
+```
+
+### 반환 값
+
+<ul class="param-ul">
+  <li class="param-li param-li-root">
+    <span class="param-type">Signature</span>
+    <br>
+    <p class="param-description">이 reflog 항목의 커미터 서명</p>
+    <ul class="param-ul">
+      <li class="param-li">
+        <span class="param-name">email</span><span class="param-required">필수</span>&nbsp;·&nbsp;<span class="param-type">string</span>
+        <br>
+        <p class="param-description">서명에 있는 이메일</p>
+      </li>
+      <li class="param-li">
+        <span class="param-name">name</span><span class="param-required">필수</span>&nbsp;·&nbsp;<span class="param-type">string</span>
+        <br>
+        <p class="param-description">서명에 있는 이름</p>
+      </li>
+      <li class="param-li">
+        <span class="param-name">timestamp</span><span class="param-required">필수</span>&nbsp;·&nbsp;<span class="param-type">number</span>
+        <br>
+        <p class="param-description">epoch 기준으로 초 단위의 시간</p>
+      </li>
+    </ul>
+  </li>
+</ul>

docs/ko/reference/ReflogEntry/Methods/idNew.md

@@ -0,0 +1,21 @@
+# idNew
+
+이 reflog 항목의 새 개체 ID(SHA1)를 가져와요.
+
+## 시그니처
+
+```ts
+class ReflogEntry {
+  idNew(): string;
+}
+```
+
+### 반환 값
+
+<ul class="param-ul">
+  <li class="param-li param-li-root">
+    <span class="param-type">string</span>
+    <br>
+    <p class="param-description">이 reflog 항목의 새 개체 ID(SHA1)</p>
+  </li>
+</ul>

docs/ko/reference/ReflogEntry/Methods/idOld.md

@@ -0,0 +1,21 @@
+# idOld
+
+이 reflog 항목의 이전 개체 ID(SHA1)를 가져와요.
+
+## 시그니처
+
+```ts
+class ReflogEntry {
+  idOld(): string;
+}
+```
+
+### 반환 값
+
+<ul class="param-ul">
+  <li class="param-li param-li-root">
+    <span class="param-type">string</span>
+    <br>
+    <p class="param-description">이 reflog 항목의 이전 개체 ID(SHA1)</p>
+  </li>
+</ul>

docs/ko/reference/ReflogEntry/Methods/message.md

@@ -0,0 +1,31 @@
+# message
+
+이 reflog 항목의 메시지를 가져와요.
+
+## 시그니처
+
+```ts
+class ReflogEntry {
+  message(): string;
+}
+```
+
+### 반환 값
+
+<ul class="param-ul">
+  <li class="param-li param-li-root">
+    <span class="param-type">null | string</span>
+    <br>
+    <p class="param-description">이 reflog 항목의 메시지. 메시지가 없으면 <code>null</code>을 반환해요.</p>
+  </li>
+</ul>
+
+### 에러
+
+<ul class="param-ul">
+  <li class="param-li param-li-root">
+    <span class="param-type">Error</span>
+    <br>
+    <p class="param-description">메시지가 유효한 utf-8이 아니면 오류를 throw해요.</p>
+  </li>
+</ul>