초안 최적화하기

초안을 완성했다면 가장 힘든 부분은 끝났습니다. 이제 이 거친 원석을 독자가 읽기 쉽고 가치 있는 보석으로 다듬을 차례입니다. 이 장에서는 제한된 시간 안에 글을 효과적으로 개선하는 방법을 다룹니다.

최적화는 크게 네 가지 영역으로 나뉩니다:

  1. 핵심: 사실(Facts), 초점(Focus), 흐름(Flow)
  2. 명확성: 명확한 문장과 소화 가능한 문단
  3. 구성 요소: 제목, 서론, 결론, 헤딩, 시각 자료, 코드
  4. 소화 가능성: 인간적인 어조, 훑어보기 좋은 구조

집중과 도전

내면의 비평가를 깨워 독자의 입장에서 글을 바라보세요. 내가 아는 것과 독자가 아는 것 사이의 간극을 인지하고, 완벽주의에 빠지지 않으면서 효율적으로 수정해야 합니다.

핵심

사실

기술적 독자들은 회의적입니다. 주장을 뒷받침할 충분한 근거를 제시해야 합니다.

  • 논쟁의 여지가 있는 진술 보강: “성능이 향상되었습니다” 대신 벤치마크 결과를 보여주세요. “이 언어가 더 직관적입니다” 대신 코드 비교를 보여주세요.
  • 팩트 체크: 내 경험, 테스트 결과, 신뢰할 수 있는 외부 자료 등을 통해 주장을 입증하세요. 근거가 부족한 주장은 과감히 삭제하는 것이 낫습니다.

초점

글의 목표에 기여하지 않는 내용은 과감히 쳐내야 합니다.

  • 불필요한 부분 삭제: 목표와 관련 없는 곁가지 이야기나 독자가 이미 알고 있을 배경 지식은 제거하거나 링크로 대체하세요.
  • 적절한 문맥 제공: 독자가 글을 이해하는 데 필요한 배경 정보(프로젝트 소개, 기술 스택 등)가 충분한지 확인하세요.
  • 크로핑(Cropping): 가장 흥미로운 부분에 집중하도록 글의 범위를 조정하세요.

흐름

글의 논리적 순서가 자연스러운지 확인하세요.

  • 순서 설명하기: 스스로 글의 전개를 설명할 수 있어야 합니다.
  • 이정표 제공: 서론에서 글의 전개 방향을 미리 알려주고, 헤딩을 통해 각 섹션의 내용을 명확히 하세요.
  • 연결 고리: 문장과 문단 사이의 연결어(However, Therefore 등)를 사용하여 논리적 흐름을 매끄럽게 만드세요.
  • 전면 배치 (Frontloading): 중요한 정보(목표, 차별점, 결과 등)를 글의 앞부분에 배치하여 독자의 관심을 즉시 사로잡으세요 (단, 버그 추적기 같은 미스터리 형식은 예외).

명확성

문장은 아이디어를 전달하는 수단입니다. 복잡하고 모호한 문장을 다듬어 독자의 인지 부하를 줄여주세요.

불분명하고 비대한 문장 최적화

  • 전치사 줄이기: 전치사 구가 너무 많으면 문장이 늘어집니다.
  • “To be” 동사 피하기: 수동태나 약한 동사(is, was) 대신 강력한 능동 동사를 사용하여 행동의 주체를 명확히 하세요.
  • 행위자와 행동 찾기: 누가 무엇을 했는지를 명확하게 드러내도록 문장을 재구성하세요.
  • 군더더기 제거: 의미 없는 단어(Very, Basically 등)나 중복된 표현을 삭제하세요.

문법과 씨름하기

문법이 완벽할 필요는 없지만, 오해를 사지 않도록 주의하세요. Grammarly 같은 도구나 AI를 활용하여 기본적인 오류를 잡고, 소리 내어 읽어보며 어색한 부분을 찾으세요.

구성 요소

제목

제목은 독자를 끌어들이는 첫 관문입니다.

  • 흥미 유발: 독자의 호기심을 자극하되 낚시성은 피하세요.
  • 검색어 포함: 타겟 독자가 검색할 만한 키워드를 포함하세요.
  • 독립성: 제목만 보고도 클릭하고 싶게 만드세요.

서론

서론에서 승부를 봐야 합니다.

  • 배경 이야기로 시작: 왜 이 글을 쓰게 되었는지 공유하세요.
  • 기대 효과 제시: 독자가 이 글을 통해 무엇을 얻을 수 있는지 명확히 하세요.
  • 독자 수준 고려: 타겟 독자에게 적절한 수준의 문맥을 제공하세요.

결론

끝까지 읽은 독자에게 보상을 주세요.

  • 요약: 핵심 내용을 정리해 주세요.
  • 의미 확장: 이 내용이 업계나 더 큰 맥락에서 어떤 의미가 있는지 짚어주세요.
  • 다음 단계: 독자가 할 수 있는 행동(피드백, 기여, 추가 학습 등)을 제안하세요.

헤딩

독자가 글을 훑어볼 때 이정표 역할을 합니다. 간결하고 내용을 잘 요약하는 헤딩을 사용하세요.

시각 자료

이미지, 다이어그램, 차트는 복잡한 정보를 효과적으로 전달합니다. 적절한 크기로 조정하고 캡션과 대체 텍스트(ALT text)를 잊지 마세요.

코드

공유 가능한지 확인하고, 검증되었으며, 현실적이고 간결한 예제를 사용하세요. 구문 강조(Syntax highlighting)가 지원되는 방식을 사용하세요.

소화 가능성

인간미 유지하기

  • 개방성: 실수나 고민을 솔직하게 공유하여 공감을 얻으세요.
  • 대화체: 동료와 이야기하듯 자연스러운 어조를 사용하세요.
  • 직접 화법: 독자를 “사용자”가 아닌 “당신(you)”으로 지칭하세요.

훑어보기 좋게 만들기

  • 빽빽한 텍스트 나누기: 긴 문단을 나누고, 리스트나 표를 활용하세요.
  • 강조: 핵심 문구나 문장을 굵게 표시하여 시선을 유도하세요 (단, 과유불급에 주의하세요).

이것만은 꼭

시간이 없다면 다음 6단계만이라도 수행하세요:

  1. 가장 비판적인 독자의 입장에서 글을 검토하세요.
  2. 제목을 신중하게 고민하세요.
  3. 서론에서 글의 가치를 명확히 보여주세요.
  4. 헤딩을 충분히 넣고 긴 문단을 나누세요.
  5. 소리 내어 읽으며 어색한 문장을 고치세요.
  6. 문법 검사기를 활용하세요.