Code Complete

Code Complete 정리 작업 가이드

이 문서는 이 저장소에서 Code Complete 각 장 요약 파일을 만들거나 수정할 때 따를 작업 기준을 정리한 문서다.

기본 원칙

• 1차 기준은 실제 책 PDF 내용임.
• 장 요약은 책의 전개 순서와 논지 흐름을 최대한 따라감.
• 설명은 “이 책은”, “저자는” 같은 메타 표현 없이 내용 자체만 서술함.
• 한국어 문장은 장황한 설명형보다 짧고 읽히는 메모형 문장을 우선함.
• 너무 압축해서 어색한 명사 조각만 남기지 않음.
• 짧더라도 문장으로 읽히는 수준은 유지함.

Markdown 형식

• 장 제목은 ##
• 절 제목은 ###
• 절 안의 하위 비유/주제는 ####
• 본문은 bullet list 중심으로 정리함.
• 사례를 넣을 때만 한 단계 안쪽으로 들여씀.
• 사례의 실제 예시를 더 쪼개면 한 단계 더 들여씀.
• 불필요한 중첩 bullet은 만들지 않음.
• 체크리스트는 전체를 >> blockquote로 감쌈.
• 체크리스트 제목, 중간 분류, bullet, 빈 줄까지 모두 줄 앞에 >>를 붙임.
• 체크리스트 내부 중간 분류는 >> **분류명** 형식으로 둠.

• 예:

  >> #### 체크리스트: 요구사항
  >> **구체적인 기능 요구사항**
  >> - 모든 입력이 명시되어 있는가?
  >>
  >> **요구사항 품질**
  >> - 각 요구사항은 테스트 가능한가?
  

본문 작성 톤

• 메모형 어미 사용
• 예: 시작, 라고 함, 제시, 가까움, 중요함, 이동됨
• 다만 이해 확장처럼 지나치게 잘린 표현은 피함.
• 자연스러우면 ~할 수 있음, ~이 아님, ~에 가까움 형태 허용

내용 압축 규칙

• 기존 bullet 수는 함부로 늘리거나 줄이지 않음.
• 먼저 기존 bullet 단위를 유지한 채 문장만 짧게 다듬음.
• 사례가 과하면 삭제 가능
• 사례는 기본적으로 최소화함
• 본문이 길어지면 사례 삭제를 우선 검토함
• 사례를 유지할 때는 본문 논지보다 한 단계 안쪽에 배치
• 장 전체가 길어지면 사례보다 핵심 논지를 우선 남김
• bullet은 가능하면 기존 개수를 유지하고, 함부로 잘게 분해하지 않음
• 문장은 짧게 줄이되, 명사 조각처럼 어색해지지 않게 유지함

Chapter 2에서 확정된 방향

• 2.1, 2.2, 2.3 모두 같은 메모형 톤으로 통일
• modeling 같은 핵심 용어는 유지
• 2.1은 사례를 모두 제거하고 핵심 논지만 유지
• 2.2는 길 찾기 사례를 제거하고 핵심 개념만 유지
• 2.3은 비유별 구분은 유지하되 문장은 짧게 압축

Chapter 3에서 확정된 방향

• 원문 표는 장 요약 흐름에 필요한 경우 Markdown 표로 유지
• 체크리스트는 본문 요약과 시각적으로 구분되도록 전체를 >>로 감쌈
• 체크리스트는 원문 질문 형식을 유지하되 한국어로 자연스럽게 옮김

Chapter 4, 5에서 확정된 방향

• 본문은 “말하고자 하는 핵심 메시지” 중심으로 압축함
• 단, 핵심 메시지는 그것을 뒷받침하는 근거(이유·데이터)와 함께 한 문장으로 매끄럽게 제시함
  • 주장만 남긴 앙상한 명사 조각으로 줄이지 않음
  • 예: “고급 언어가 낫다”가 아니라 “고급 언어일수록 표현력이 높아 한 줄이 더 많은 일을 함”처럼 근거까지 담음
• 용어 사전식 나열은 제거함 (예: 4장의 언어별 설명, 5장의 설계 패턴 표)
  • 나열 자체가 핵심 논지가 아니면 빼고, 그것이 뒷받침하던 한 줄 논지만 남김
• 짧은 예시는 핵심을 보여주면 한 줄씩 적극적으로 붙임 (글만 있으면 허전하므로), 단 장황한 일화나 사전식 나열은 지양
  • 가능하면 원문에 나오는 예시를 그대로 씀 (예: “집” 추상화, sin() 결합, Tacoma Narrows 다리)
• 데이터·표는 흐름에 꼭 필요할 때만 유지함, 단순 데이터/사전식 표는 제거하고 한 줄 논지로 대체함
  • 제거한 표: 표 4-1(언어별 비율), 표 5-1(설계 패턴), 표 5-2(설계 형식성)
• 원문에서 비슷한 항목이 여러 ####로 흩어져 있으면, 한 묶음 아래 하위 bullet로 합침
  • 예: 5.1의 설계 7가지 본성은 #### 7개 대신 한 절 아래 bullet 7개로 정리
• minor 항목이 많을 때는 개별 설명 대신 이름만 한 bullet에 나열함
  • 예: 5.3의 “그 밖의 발견법” 11가지는 이름만 나열
• 관련 있는 항목이라도 억지로 한 묶음으로 합치지 않음, 원문처럼 개별 항목으로 두는 편이 더 읽힘 (추상화·캡슐화·정보 은닉을 묶었다가 오히려 헷갈려 되돌림)
• 구조 요소(체크리스트, 참고 자료, 요점 정리)는 유지하되 분량은 압축함
  • 참고 자료는 항목·구조는 보존하되 설명을 짧은 구로 줄이거나 한 줄에 묶음
  • 요점 정리는 기존대로 문장형을 유지함

참고 자료 / 요점 정리

• 참고 자료와 요점 정리는 항상 유지
• 이 두 부분은 장 요약의 필수 구성으로 간주
• 가능하면 책의 구조와 항목 수를 유지
• 표현은 한국어로 정리하되, 원문 의미와 배열은 최대한 보존
• 요점 정리는 본문처럼 메모형으로 과도하게 줄이지 않음
• 요점 정리는 Chapter 2의 요점 정리처럼 자연스러운 문장형 bullet을 유지함
• 본문은 메모형 요약, 요점 정리는 비교적 완결된 문장형 요약으로 구분함

작업 절차

• 먼저 PDF에서 해당 장과 절을 직접 확인
• 초안 작성 후 책 흐름과 항목 순서가 맞는지 점검
• 사용자 피드백이 생기면 문체, bullet 수, 사례 처리 방식을 이 문서에 반영
• 이후 장 작업 시 이 문서를 먼저 참고한 뒤 작성

This site is open source. Improve this page.