문서화 3

SHFB에서 namespace의 문서 작성하기

SHFB(Sandcastle Help File Builder)를 이용하여 .NET 프로젝트 문서화를 할 때(코드주석 문서화하자 참조) namespace에 해당하는 페이지에서는 항상 문서화 주석이 없다는 붉은 오류 메시지가 포함되어 상당히 보기 안좋았는데, 오늘 잠깐 검색을 해서 방법을 찾았습니다. 이것은 SHFB에 포함된 도움말의 색인에서 NamespaceDoc class 항목을 찾아보면 볼 수 있는 내용입니다. 해당 네임스페이스에 NamespaceDoc 이라는 클래스를 만들고 그 클래스에 문서화 주석을 달면 SHFB가 빌드할 때 네임스페이스 도움말로 바꿔줍니다. 아래와 같은 코드를 만드는거죠. namespace TheNamespace { /// /// 이 네임스페이스로 말할 것 같으면, 아무튼 멋지구리..

2011.03.10

Visual Studio의 XML 문서화 주석 활용하기

지난 스프린트부터 XML 문서화 주석을 충실히 작성하여 활용하기로 결정했다. 그러기 위해서 주석도 코드 리뷰 대상으로 포함시켜서 품질을 유지하기로 했다. 그리하여 Visual Studio의 XML 문서화 주석을 이용해서 MSDN 스타일의 도움말 파일을 만들어 내는 방법을 경민 씨가 자이닉스 개발부 블로그에 잘 정리해주었다. Xinics 개발부 - 코드 주석 문서화하자

2010.04.05

시각화, 문서화

cavin이라는 아이디를 사용하시는 분의 블로그 포스트에서 구글 독스 소개 동영상을 보았다. 위 동영상을 보면 UI 프로토타이핑에서 사용하는 페이퍼 프로토타이핑 기법을 이용했다고 볼 수 있는데, 메일의 단점과 그에 비한 구글 독스의 장점을 간단한 그림과 설명을 통해 잘 표현하고 있다. 이 동영상을 보니 문득 영회님의 블로그에서 본 산출물을 영리하게 만들지 못할 뿐, 애꿎은 산출물 탓은 하지 말자라는 포스트가 떠올랐다. 어떻게 하면 의도를 잘 전달할 수 있는가? 꼭 문서의 형태로 정리해야 하는가? 하는 의문에 대한 답이 될 수 있는 영상과 블로그 포스트라고 생각한다. 문서화 작업이라는 것이 귀찮고 하기 싫은 일임은 분명하다. 내게 있어서는 스스로 잘 할 수 있다는 충분한 자신감이 없다는 것도 하기 싫은 이..

2009.11.15