117 lines
3.9 KiB
Markdown
117 lines
3.9 KiB
Markdown
---
|
|
title:
|
|
source_type: blog
|
|
status: draft
|
|
confidence: unknown
|
|
tags: [blog]
|
|
related_projects: []
|
|
last_reviewed:
|
|
canonical_sources: []
|
|
audience: backend-engineer
|
|
target_publish:
|
|
status_label: outline
|
|
---
|
|
|
|
# {{title}}
|
|
|
|
> Layer: `wiki/blog/` — **외부 공개용 블로그 글 초안·완성본**. canonical (`wiki/concepts/` + `wiki/projects/`) 에서 파생된 산출물.
|
|
> 상태: draft → reviewed → verified → **published-ready** (외부 게시 가능)
|
|
> `status_label`: `outline` | `drafting` | `review` | `ready` | `published` | `retired`
|
|
> `audience`: `backend-engineer` | `senior-engineer` | `tech-lead` | `general` — 깊이·전문용어 사용량이 달라짐.
|
|
|
|
## 부모 (필수)
|
|
|
|
> wiki/blog/ 는 derived layer. **반드시 canonical wiki/concepts/ 또는 wiki/projects/ 에서 파생.** raw 또는 branch에서 직접 파생 금지.
|
|
|
|
- 핵심 canonical (최소 1개+):
|
|
- `[[wiki/concepts/<...>]]` — <어떤 개념을 다루는지>
|
|
- `[[wiki/projects/<...>]]` — <어떤 프로젝트 사실을 다루는지>
|
|
- 영감 출처 (선택):
|
|
- `[[raw/blog-topics/<...>]]` — <어떤 raw 글감이 출발점이었나>
|
|
- `[[raw/job-postings/<...>]]` — <어떤 공고가 글감을 자극했나>
|
|
- `[[raw/interviews/<...>]]` — <어떤 면접 질문에서 파생>
|
|
|
|
## 타깃 독자
|
|
|
|
> 이 글을 누가 읽을 것인지. 톤·전문용어·깊이가 결정됨.
|
|
|
|
- 독자 profile:
|
|
- 독자가 이미 알고 있을 것이라 가정하는 것:
|
|
- 독자가 처음 듣는다고 가정하는 것:
|
|
|
|
## 도입
|
|
|
|
> 왜 이 글을 쓰는가. 독자에게 이 글의 가치를 1~2문장으로.
|
|
|
|
- 문제 / 궁금증:
|
|
- 이 글이 답하는 것:
|
|
- 이 글이 답하지 않는 것 (스코프):
|
|
|
|
## 본문 outline
|
|
|
|
> 글의 흐름. 초안 단계에서는 outline 만, drafting 단계부터 본문.
|
|
|
|
1. <섹션 1 제목> — <핵심 메시지 한 줄>
|
|
2. <섹션 2 제목> — <핵심 메시지 한 줄>
|
|
3. <섹션 3 제목> — <핵심 메시지 한 줄>
|
|
|
|
## 본문
|
|
|
|
> drafting 단계에서 채움. 모든 사실 주장은 canonical 인용으로 뒷받침.
|
|
|
|
(여기에 글 본문)
|
|
|
|
## 코드 예제
|
|
|
|
> 가능한 실제 프로젝트 코드 인용. 가짜 예제 금지. 추출 시 출처 PR·커밋 명시.
|
|
|
|
```<lang>
|
|
// 출처: [[wiki/projects/<...>]] — <commit-sha>
|
|
<code>
|
|
```
|
|
|
|
## 근거 (canonical 인용 필수, derived layer 의무)
|
|
|
|
> 모든 사실 주장은 canonical 또는 raw 인용으로 뒷받침. 자기 추론은 명시적으로 "내 해석" 으로 분리.
|
|
|
|
- `[[wiki/concepts/<...>]]` — <어떤 사실의 출처>
|
|
- `[[wiki/projects/<...>]]` — <어떤 결정의 출처>
|
|
- `[[raw/official-docs/<...>]]` — <인용한 공식 자료>
|
|
- `[[raw/company-tech-blogs/<...>]]` — <인용한 사례>
|
|
|
|
## 사실 vs 의견
|
|
|
|
> 독자가 자신 있게 인용할 수 있도록.
|
|
|
|
- **사실 (검증됨)**:
|
|
- <항목> — 근거: `[[wiki/...]]` 또는 `[[raw/...]]`
|
|
- **내 해석·의견 (검증 안 된 추론)**:
|
|
- <항목> — "내 경험상" / "내 해석으로는" 같은 표현으로 명시
|
|
- **알지 못하는 것**:
|
|
- <항목> — "이 부분은 다음 글에서 다루겠다" 또는 솔직히 표기
|
|
|
|
## 답할 수 있는 범위
|
|
|
|
> 이 글을 읽은 사람에게 후속 질문을 받았을 때 자신 있게 답할 수 있는 범위.
|
|
|
|
- 자신 있게 답할 수 있는 후속 질문:
|
|
- "그건 다음 글에서 다루겠다" 라고 해야 하는 부분:
|
|
|
|
## 게시 체크리스트
|
|
|
|
`ready` → `published` 로 올리기 전 확인.
|
|
|
|
- [ ] 모든 사실 주장에 canonical 링크 있음
|
|
- [ ] 사실 vs 의견 분리 명시됨
|
|
- [ ] 과장 단어 (`완벽`, `극한`, `100%`, `최고`, `역사상 가장`) 없음
|
|
- [ ] 코드 예제 출처 명시
|
|
- [ ] 타깃 독자 가정과 톤 일치
|
|
- [ ] `/lint` 통과
|
|
- [ ] 게시 URL 기록 (게시 후):
|
|
|
|
## 관련
|
|
|
|
- 후속 글 후보: `[[wiki/blog/<...>]]`
|
|
- 관련 포트폴리오 항목: `[[wiki/portfolio/<...>]]`
|
|
- 영감을 받은 raw 자료: `[[raw/blog-topics/<...>]]`, `[[raw/job-postings/<...>]]`, `[[raw/lectures/<...>]]`
|