11장. 읽기 쉬운 엔지니어링 전략 작성하기
이 작품은 AI를 사용하여 번역되었습니다. 여러분의 피드백과 의견을 환영합니다: translation-feedback@oreilly.com
이 책에서 이 시점까지 완전한 엔지니어링 전략에는 탐색, 진단, 구체화, 정책 설정, 운영의 다섯 가지 구성 요소가 있다는 것을 배웠을 것입니다. 이는 전략을 작성하는 데 효과적인 순서이지만, 각 결정의 배경이 되는 전체 사고를 이해하지 않고 전략을 빠르게 읽고 적용하려는 사람들에게는 어려운 순서입니다. 전략을 작성하는 순서가 반드시 청중이 읽어야 하는 순서와 일치하는 것은 아닙니다.
이 장에서 다루는 내용은 다음과 같습니다:
-
전략 작성 순서가 읽기 어려운 이유
-
읽기 쉽게 전략 문서를 정리하는 방법
-
가독성을 높이기 위해 컴포넌트를 리팩터링하고 병합하는 방법
-
효과적인 전략 문서 작성을 위한 추가 팁
전략을 읽은 후에는 작성된 전략을 다른 사람들이 훨씬 더 읽기 쉬운 버전으로 재작업할 수 있어야 합니다.
글쓰기 구조가 읽기를 방해하는 이유
대부분의 소프트웨어 엔지니어링 담당자는 학생 시절부터 문서 구조를 배웁니다. 학술 에세이는 명확한 논지를 뒷받침하는 증거를 제시하고 일반적으로 결론을 향해 나아가는 논증을 구축합니다. 일부 비즈니스 컨설팅 회사에서는 신입 사원에게 비즈니스 글쓰기 교육을 실시하는데, 예를 들어 McKinsey에서는 바바라 민토의 피라미드 원칙을 가르칩니다: 글쓰기와 사고의 논리 (프렌티스 홀, 2010)를 가르치기도 하지만 이는 예외입니다.
학술 에세이는 논증을 전개하고자 하는 것이지만, 전문적인 글쓰기는 조금 다릅니다. 전문적인 글쓰기에는 일반적으로 세 가지 목표 중 하나가 있습니다:
- 주어진 접근 방식에 대한 생각 다듬기
-
"신제품을 위한 데이터베이스를 어떻게 선택해야 할까요?" 이 질문은 제안 자체보다는 제안의 배경이 되는 사고에 초점을 맞추기 때문에 학문적 구조가 유용할 수 있는 영역입니다.
- 이해관계자 또는 경영진의 승인 구하기
-
"새로운 분석 제품을 위해 어떤 데이터베이스를 선택했나요?" 학술적 구조는 이해관계자가 검토해야 할 주요 주제로 간주하는 특정 제안보다는 사고에 초점을 맞추기 때문에 여기서 많은 혼란을 야기할 수 있습니다.
- 조직에 정책 전달하기
-
"데이터베이스는 신제품에 허용됩니다." 이러한 유형의 글은 회사의 엔지니어들이 주어진 문제에 대해 허용되는 옵션을 이해하도록 돕고, 현재 정책을 이해하거나 이의를 제기하려는 사람들을 위해 결정의 근거를 설명하는 것입니다.
첫 번째 경우에 이상적인 형식은 일반적으로 다른 두 가지와 상충되는 경우가 많으며, 이것이 전략 문서가 브레인스토밍에서 정책으로 발전하는 데 어려움을 겪는 빈번한 이유입니다. 대부분의 전략 작성자는 초기 문서를 재구성하는 데 시간을 투자할 가치가 있다는 생각에 저항하기 때문에 제가 개인적으로 재구성하지 않고 진전을 이루려고 시도했을 때 겪었던 어려움에 대해 말씀드리겠습니다.
너무 길어서 읽지 않음
사고 지향적 구조에서는 정책 권장 사항을 맨 ...
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Read now
Unlock full access