문서화 작업이 얼마나 중요한가요?

gurugio의 이미지

저는 지금 대학원 연구실에 있는데요
제 주위에는 정말 프로그래밍을 잘하는 분도 계시고
하드웨어를 잘 알아서 회로도만 보고 WinCE도 포팅하고 어플도 짜고 하시는
저같은 초보가 보기에 학생이면서도 대단하신 분들이 계십니다.

그런데 이분들은 문서 작업을 거의 하지 않으십니다.
머리가 좋으셔서 그런지 작업한 내용을 기록하거나 하시지 않고
소스에 주석도 상세하게 안쓰시더라구요.

책에서는 문서 작업을 잘하고 작업 기록도 상세하게 남기고
문서화 작업이 대단히 중요하다고 배웠습니다만
이게 저같은 초보들에게 중요하고
실력이 좋아지면 별로 필요없는 작업인지 궁금합니다.

또 얼마전부터 조엘온소프트웨어 책을 읽고
책에 나온 일정 관리와 버그 리스트 만드는 방법대로
제 데스크탑에 설치된 위키에 일정과 버그 리스트를 적고있는데요
혹시 어떤 방법이든지 일정 관리를 하시거나
버그 리스트 관리를 하시는 노하우가 있다면
알려주시길 부탁드립니다.

코딩도 잘 못하면서 너무 높은 것부터 바라보는게 아닌지 모르겠네요.. oops

madhatter의 이미지

문서작업을 게을리하는 건 개발자의 가장 안좋은 버릇입니다.
실력이 좋아질수록 문서화 노하우도 쌓여가야 이상적인 거죠.

ssggkim의 이미지

인수인계도 필요없고 혼자서 모든 것을 다 해야만하는 프로젝트를 수행한다면 모를까, 공동 작업시 문서화는 필수입니다.

나는오리의 이미지

문서화가 필요한 이유는 멀리는 10년 가까이는 1년을 두고 다시 그 프로그램을 손봐야 할 때 필요한거죠.

그분들이 프로그램쪽은 실력이 좋을지 모르나
문서화 실력은 낮은것 같습니다.

욱성군의 이미지

조엘 온 소프트웨어를 읽어보셔요!

nike984의 이미지

gurugio wrote:
저는 지금 대학원 연구실에 있는데요
제 주위에는 정말 프로그래밍을 잘하는 분도 계시고
하드웨어를 잘 알아서 회로도만 보고 WinCE도 포팅하고 어플도 짜고 하시는
저같은 초보가 보기에 학생이면서도 대단하신 분들이 계십니다.

그런데 이분들은 문서 작업을 거의 하지 않으십니다.
머리가 좋으셔서 그런지 작업한 내용을 기록하거나 하시지 않고
소스에 주석도 상세하게 안쓰시더라구요.

책에서는 문서 작업을 잘하고 작업 기록도 상세하게 남기고
문서화 작업이 대단히 중요하다고 배웠습니다만
이게 저같은 초보들에게 중요하고
실력이 좋아지면 별로 필요없는 작업인지 궁금합니다.

또 얼마전부터 조엘온소프트웨어 책을 읽고
책에 나온 일정 관리와 버그 리스트 만드는 방법대로
제 데스크탑에 설치된 위키에 일정과 버그 리스트를 적고있는데요
혹시 어떤 방법이든지 일정 관리를 하시거나
버그 리스트 관리를 하시는 노하우가 있다면
알려주시길 부탁드립니다.

코딩도 잘 못하면서 너무 높은 것부터 바라보는게 아닌지 모르겠네요.. :oops:

대학 연구실은 아직 회사 처럼 formal한 형식을 요구하지 않고 좀
자유분방해서 그렇지 않을까요? 점점 공동 작업이 많아지면
문서화 작업은 필수죠.
예전에 있던 연구실에도 삼성서 교육 나오신 분이 계셨는데 문서 작업
하나는 정말 기깔나게 잘하시더군요. 덕분에 옆에서 문서 작업하는
방법을 조금 익혔습니다.

7339989b62a014c4ce6e31b3540bc7b5f06455024f22753f6235c935e8e5의 이미지

욱성군 wrote:
조엘 온 소프트웨어를 읽어보셔요!

gurugio wrote:

또 얼마전부터 조엘온소프트웨어 책을 읽고
책에 나온 일정 관리와 버그 리스트 만드는 방법대로
제 데스크탑에 설치된 위키에 일정과 버그 리스트를 적고있는데요

:oops: