1. 컴퓨터 제품에 필요한 문서들

• 목표 (요구사항, 최종 목표, 필요한 것, 제약 조건, 우선 순위)
• 명세 (컴퓨터 매뉴얼 + 성능 명세)
• 일정
• 예산: 예산의 존재는 제약이 없었으면 내리지 않았을 기술적 결정을 내리게 하며, 더 중요하게는 정책적 결정을 강제하고 그 내용을 명확하게 한다.
• 조직도
• 공간 배치
• 측정, 예측, 가격: 이 세 가지가 서로 맞물리면서 프로젝트의 성패를 결정한다.
  1. 시장을 예측 하기 위해서는 성능 명세와 대략의 제품 가격이 필요한다.
  2. 예측에서 나온 가망 수량은 설계 상의 부품 개수와 함께 재료 비용 추정치 를 결정한다.
  3. 추정치를 통해서 제품 하나 당 개발비와 고정비가 나오며 이 비용은 다시 제품의 가격 을 결정하게 된다.

2. 대학의 학과에 필요한 문서

 목적과 활동 내용이 컴퓨터와는 엄청난 차이가 있음에도 불구하고, 대학교 학과장에게 필수적인 문서 목록 역시 개수나 종류 면에서 컴퓨터와 별반 다르지 않다.

• 목표
• 강좌 설명서
• 학위 취득 요건
• 연구 제안서 혹은 연구 계획서
• 수업 일정표 및 교수 배정안
• 예산
• 공간 배치
• 사무직원 및 대학원생 배정안

 컴퓨터 프로젝트 문서와 대학의 학과 문서에 유사성은 절대 우연이 아니다.

 어떠한 관리 업무라도 관심사는 무엇을, 언제, 얼마나, 어디서, 누가 하느냐에 있다.

3. 소프트웨어 프로젝트의 문서들

• 무엇을: 목표. 여기에는 충족되어야 할 요구사항, 최종 목표, 필요한 것, 제약 조건, 우선 순위가 담겨 있다.
• 무엇을: 제품 명세. 이 문서는 제안서로 시작해서 매뉴얼 및 내부 문서화로 끝난다.
• 언제: 일정.
• 어디서: 공간 할당
• 얼마나: 예산
• 누가: 조직도. "시스템을 설계하는 조직은 그 조직의 의사소통 구조를 본뜬 시스템을 만들어 내게 되어있다." by Conway.
  따라서 시스템 설계가 자유롭게 변경될 수 있어야 한다면, 조직 역시 변화에 대비 하고 있어야 한다.

4. 왜 형식을 갖춘 문서를 만드는가?

1. 결정된 사항을 글로 적는 것이 필수불가결하기 때문이다. 오로지 글로 적은 때에만 빠진 곳이 나타나고 모순들이 드러난다.
2. 결정된 내용은 그 문서를 통해 다른 이들에게 알릴 수 있기 때문이다. 관리자의 기본 업무는 모든 사람이 같은 방향으로 계속 가게 하는 것이다. 이때 그의 문서들은 소통에 따르는 부담을 엄창나게 줄여줄 것이다.
3. 관리자의 문서는 데이터베이스와 체크리스트 역할을 하기 때문이다. 그 문서들은 추가적으로 검토함으로써 자신의 현 위치를 알며, 방향성을 강조해야 하는지 수정해야 하는지 알 수 있다.

 관리자의 과업은 계획을 세우고 그것을 실현하는 것이다. 그러나 오직 글로 적은 계획 만이 명확하며 전달 가능하다. 그건 계획을 무엇을. 언제. 어디서. 누가 라는 내용을 기술한 문서들로 이루어진다.

 이 소수의 핵심 문서는 관리자 업무의 대부분을 요약하고 있다.

출처

[책] 맨먼스 미신: 소프트웨어 공학에 관한 에세이 (프레더릭 브룩스 지음, 강중빈 옮김)