시스템 개발에서 모두가 이해가능한 문서 작성.

  전규현님의 블로그에서 읽은 포스팅을 배경으로 트랙백 날립니다. 먼저 전적으로 공감하는 전규현님의 글을 읽고 실제 프로젝트 상황에서 요구사항 관리상의 관련 활동에서 가장 기초적이고 끝까지 잃지 말아야 하지만, 그게 쉽지만은 않은 전제조건이 무엇일까 하는 물음에 다음과 같이 4가지로 정리를 해봤습니다.

1. 프로젝트의 범위와 목적을 명확하게
  엄청엄청 중요한 조건이 아닌가 생각을 합니다. 프로젝트 착수 후, 프로젝트의 범위와 목적이 나오게 됩니다.(조직 환경에 따라 범위와 목직이 나온 후 프로젝트가 착수되기도 합니다.) 범위와 목적(Scope & Goal)은 개발 대상의 프로덕트의 특성 및 전체 프로젝트 스케쥴, 예산 규모에 막대한 영향을 끼치게 됩니다. 그렇기 때문에, stakeholder간의 충분한 협상과 대화를 통해 명확한 범위와 목적이 잡혀야 합니다. 추가적으로 프로젝트 베이스라인(baseline)을 만들어주면 좋겠지요.

2. 꾸준한 커뮤니케이션
  stakeholder는 크게 developer, manager, client, customer, user로 나눌 수 있습니다. 하지만 저마다의 View가 조금씩 차이를 보이게 되기도 하지요. 때문에 충분하고 지속적인 커뮤니케이션 활동은 아무리 강조해도 지나치치 않을 정도입니다. 커뮤니케이션의 목적은 서로 다른 View의 격차를 조금이라도 줄이고 개발 대상의 프로덕트에 대한 명확한 이해를 위해서 꼭 행하여야 하는 활동입니다.

3. 변경 이벤트 발생 시, 반드시 공유
  특히 소프트웨어 제품의 경우 조직환경 또는 예산에 따라, 고객의 요구에 따라 요구사항이 변화하기 때문에 제품의 특성 자체가 달라지는 경우도 있습니다. 빈번하게 발생하는 요구사항 변경 때문에 꾸준한 요구사항의 관리를 해주어야 하고, 변경 이벤트가 발생 시, 개발자 또는 관리자 간의 충분한 대화를 통해 서로 변경된 요구사항에 대해 정확하게 파악하고 있어야 합니다. 서로 다른 버전의 문서들을 보고 개발한다면 개발 후, 시스템은 분명 Error로 보답을 하게 되겠지요.

4. 용어사전의 통일
  앞서 언급한 꾸준한 커뮤니케이션의 활동을 강조하였는데, 커뮤니케이션 활동 및 문서작성 활동에 있어서 또 하나의 중요하게 지켜질 전제가 바로 용어사전(Glossary)의 통일입니다. 서로다른 어휘로 쓰여진 문서보단 통일된 문서로 관리를 하는게 당연히 더욱 편하고 이해관계자들 사이에서 오해를 불러일으킬만한 소지를 없앨수가 있겠지요.

이 글과 관련있는 글을 자동검색한 결과입니다 [?]

by hoya | 2009/02/17 10:19 | 소프트웨어이야기 | 트랙백(1) | 덧글(3)

트랙백 주소 : http://senet.egloos.com/tb/2237116
☞ 내 이글루에 이 글과 관련된 글 쓰기 (트랙백 보내기) [도움말]
Tracked from All of Softw.. at 2009/02/17 13:33

제목 : 개발자도 문서를 잘 작성할 수 있어야 한다.
개발자(엔지니어)들이 문서를 잘 작성하지 못한다는 것은 익히 알려져 있는 사실입니다. 개발자에게 프로그래밍 실력이 더 중요하지 문서 작성 기술이 얼마나 중요하겠냐?라고 생각하는 사람이 있을 수도 있겠지만, 개발자가 성장할수록 문서 작성 능력의 중요도는 점점 더 커집니다. 문서를 잘 작성하지 못하는 개발자는 협업을 하는데 있어서 치명적인 결함을 가지고 있다고 할 수 있습니다. 그럼 문서를 잘 작성하는 것은 무엇이고? 문서를 잘 작성하지 못하는 것......more

Commented by Ray at 2009/02/17 13:39
핵심을 잘 정리했네요. ^^
Commented by novrain at 2009/02/17 15:04
매우 기초적이면서도 간단한 내용이네요. 그런데도 불구하고 지키기는 왜 이렇게 힘들지 모르겠습니다.
(그리고 링크 신고드립니다.)
Commented by hoya at 2009/02/17 15:09
잘 지켜진다면.. 우리나라 소프트웨어 산업은 엄청나게 발전할 것입니...ㅜㅜ
※ 이 포스트는 더 이상 덧글을 남길 수 없습니다.
Creative Commons License 이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-동일조건변경허락 3.0 Unported 라이센스에 따라 이용하실 수 있습니다.

 

◀ 이전 페이지다음 페이지 ▶