# 제목·도입·결론

## 제목

대상과 행동 또는 갈등을 드러낸다.

| 약한 제목 | 개선 방향 |
|---|---|
| Kubernetes 살펴보기 | Kubernetes로 배포 롤백을 자동화한 방법 |
| 성능 개선 이야기 | 검색 API p95를 420ms에서 180ms로 줄인 과정 |
| Kafka 도입기 | 장시간 작업에서 Kafka 대신 RDB Task Queue를 선택한 이유 |

수치 제목은 근거와 범위가 명확할 때만 사용한다.

## 도입

첫 15% 안에 다음 세 가지를 드러낸다.

1. 어떤 시스템·작업에서 무슨 문제가 있었는가
2. 왜 독자에게 중요한가 또는 어떤 제약이 있었는가
3. 글을 읽으면 무엇을 알 수 있는가

시대 일반론, 의례적 인사, ‘여정을 살펴보겠다’는 메타 문장으로 시작하지 않는다.

## 소제목

`소개`, `배경`, `내용`, `결론`만 쓰지 말고 절의 판단이나 동작을 표현한다.

- `배경` → `배포가 18분 걸린 이유`
- `구현` → `실패 단계를 분리해 로그를 남기기`
- `결과` → `평균 배포 시간은 줄었지만 승인 대기는 남았다`

## 결론

다음 중 실제 자료가 있는 항목으로 끝낸다.

- 어떤 결정을 내렸는가
- 어떤 결과를 어떤 조건에서 확인했는가
- 무엇은 해결하지 못했는가
- 어디까지 적용 가능한가
- 다음에 무엇을 측정하거나 바꿀 것인가

본문을 다시 요약하거나 ‘더 나은 미래’, ‘많은 것을 배웠다’, ‘지속적으로 발전시키겠다’로 끝내지 않는다.