상세 컨텐츠

본문 제목

프로젝트의 문서 템플릿 관리하기

IT 세상

by 이현민 (지후지율아빠) 2009. 1. 24. 07:25

본문

프로젝트의 문서 템플릿 관리하기

CollabNet Baseline Project 템플릿은 프로젝트 팀 참여자가 특정 프로젝트 스테이지와 관련된 작업을 수행하는 데 사용할 수 있는 문서 템플릿을 제공합니다. 템플릿을 사용하여 프로젝트 소유자는 프로젝트 전체와 프로젝트 참여자 간에 표준 작업 방법을 적용할 수 있습니다. 예를 들어, 새로운 사용 사례를 생성할 때 프로젝트 참가자는 사용 사례 템플릿의 복사본을 열어 새 파일로 저장하고, 새로운 사용 사례를 입력하기 위한 기준으로 이 파일을 사용할 수 있습니다.

CollabNet Baseline Project 템플릿을 사용하는 프로젝트를 처음 설정할 때 서브페이지와 페이지의 랜딩 페이지에는 프로세스 문서 테이블이 포함되어 있습니다. 이 테이블 바로 위에는 프로세스 문서 템플릿을 보는 링크가 있습니다. 이 링크를 클릭하면 사용 가능한 모든 템플릿을 표시하는 페이지를 볼 수 있습니다.

프로젝트를 시작할 때 각 프로세스 문서 테이블이 일부 문서 템플릿의 사본을 표시합니다. 테이블의 문서는 템플릿 페이지에 표시되는 템플릿의 다른 위치에 있으며 템플릿 페이지의 사용 가능한 모든 템플릿의 하위 집합입니다.

해당 조직의 표준에 맞는 스타일을 가져오도록 템플릿을 수정하거나 내용을 수정할 수 있습니다. 특정 서브페이지 또는 페이지 작업에 대한 자세한 내용은 새 문서 업로드에 대한 사용자 도움말 또는 프로젝트 템플릿 설정에 대한 관리 도움말을 참조하십시오.

다음 테이블에서는 CollabNet Baseline Project 템플릿을 사용하는 프로젝트와 함께 제공되는 템플릿을 설명합니다.

페이지 . . 연관된 템플릿 . .
정의
  • 기능 개요 - 요구사항을 기능에 매핑하는 방법에 대한 지침을 제공합니다. 일반적으로 기능마다 하나의 사양이 작성됩니다.
  • 기능 사양 - 사용자에게 표시된 제품의 동작으로 기능을 설명합니다. 기능을 정의하지만 구현 전략이나 세부사항은 설명하지 않고, 설계에 필요한 기술 정보를 제공합니다. 일반적으로 기능마다 하나의 사양이 작성됩니다.
  • 마케팅 요구 사항 문서(MRD) - 일반적으로 프로젝트마다 하나의 MRD만 사용됩니다.
  • 제품 요구 사항 문서(PRD) - 일반적으로 프로젝트마다 하나의 PRD만 사용됩니다.
  • 요구 사항 스프레드시트- 일반적으로 프로젝트마다 하나의 스프레드시트만 사용됩니다.
  • 사용 사례 템플릿 설명 - 사용 사례 템플릿을 사용하는 방법에 대한 지침을 제공합니다.
  • 사용 사례 템플릿 - 작성자, 날짜, 사용 사례 흐름, 전제 조건, 사후 조건 등을 포함하여 사용 사례 작성 시 지침을 제공합니다. 일반적으로 기능마다 하나의 사용 사례가 작성됩니다.
설계
  • 형상 관리 계획 - 산출물 ID, 이름 지정, 기본 생성, 라벨, 분기, 병합 등을 포함하여 형상 관리에 대한 모든 IEEE 표준을 포함하고 있습니다. 일반적으로 릴리즈마다 하나의 계획이 작성됩니다.
  • 설계 계획 - 이 템플릿의 용도는 시스템의 신규 또는 업데이트된 설계의 중요사항을 캡처하는 것입니다. 시스템이 변경될 형태를 식별하기 위한 섹션을 제공합니다. 일반적으로 기능마다 하나의 사양이 작성됩니다.
  • 소프트웨어 아키텍처 문서 - 설계할 구성요소 및 구성요소 간 관계를 포함하여 소프트웨어 설계의 가장 중요한 결정 사항에 관한 지침을 제공합니다. 일반적으로 릴리즈마다 하나의 소프트웨어 아키텍처 문서가 작성됩니다.
  • 시스템 아키텍처 문서 - 시스템 레벨 요소 및 시스템 레벨 요소 간 관계에 관하여 가장 중요한 결정 사항에 대한 지침을 제공합니다. 일반적으로 릴리즈마다 하나의 시스템 아키텍처 문서가 작성됩니다.
코드 및 빌드
  • 코드 검토 - 코드 검토 예상 및 접근 방식을 문서화하는 방법에 대하여 설명합니다. 검토 중 묻는 질문도 제공합니다.
  • 개발 가이드라인 - 개발자를 위한 가이드라인을 제공합니다.
테스팅
  • 테스트 케이스 - 개별 테스팅 순서를 문서화하는 방법을 설명합니다. 일반적으로 요구 사항마다 하나의 테스트 케이스가 작성됩니다.
  • 테스트 계획 - 테스팅 범위, 테스트할 항목, 테스팅 접근 방식 등을 문서화하는 방법을 설명합니다. 일반적으로 릴리즈마다 하나의 테스트 계획이 작성됩니다.
배치
  • 배치 검사 목록 - 고객에게 소프트웨어를 성공적으로 릴리즈하는 활동을 문서화하는 지침을 제공합니다.
  • 릴리즈 관리 계획 - 릴리즈 목적, 설치 요구 사항, 사전 공개 미팅, 사후 구현 테스팅 등을 문서화하는 지침을 제공합니다.
  • 릴리즈 정보 - 릴리즈에서 해결된 고객이 당면한 결함 및 릴리즈 강조 사항을 문서화하는 지침을 제공합니다.
  • 소프트웨어 설치 가이드 - 소프트웨어 설치, 초기 설정 및 시작을 문서화하는 지침을 제공합니다.
지원
  • 지원 계획 - 지원 임무, 지원 성공 기준, 지원 역할 및 책임, 그리고 ITIL 기반 지원 프로세스 영역에 대한 전략을 캡처하는 영역을 문서화하는 지침을 제공합니다. 일반적으로 릴리즈마다 하나의 지원 계획이 작성됩니다.
프로젝트 관리
  • 사업 사례 - 비즈니스 문제, 문제를 해결할 프로젝트에 대한 제안 및 프로젝트 값 제안에 대한 섹션을 제공합니다.
  • 프로젝트 완료 검토 - SWOT(Strengths, Weaknesses, Opportunities and Threats) 메소드 사용을 기준으로 완료된 프로젝트에서 학습한 단원을 캡처합니다.
  • 프로젝트 계획 - 프로젝트 요약, 범위, 성공 기준, 생명주기 접근방식, 가정, 제한사항, 위험 관리 계획, 인적 자원 계획, 작업 분할 구조, 외부 공급자 계획 등에 대한 섹션을 제공합니다.
  • 프로젝트 일정(Waterfall, Iterative 및 Agile) - 각 프로세스 유형에 대한 개별 템플릿 파일입니다.
Cruise Control
  • 코드 검토 - 코드 검토 예상 및 접근 방식을 문서화하는 방법에 대하여 설명합니다. 검토 중 묻는 질문도 제공합니다.
  • 개발 가이드라인 - 개발자를 위한 가이드라인을 제공합니다.
Test Director
  • 테스트 케이스 - 개별 테스팅 순서를 문서화하는 방법을 설명합니다. 일반적으로 요구 사항마다 하나의 테스트 케이스가 작성됩니다.
  • 테스트 계획 - 테스팅 범위, 테스트할 항목, 테스팅 접근 방식 등을 문서화하는 방법을 설명합니다. 일반적으로 릴리즈마다 하나의 테스트 계획이 작성됩니다.

문서 템플릿 수정하기

사용자가 서브페이지 또는 페이지의 랜딩 페이지를 보면 프로젝트 문서가 포함된 테이블을 볼 수 있습니다. 이 페이지에 문서 템플릿 보기 링크가 있는 경우 이 서브페이지나 페이지의 프로젝트 템플릿을 추가하거나 이 서브페이지나 페이지에 대한 템플릿을 수정할 수 있습니다.

프로세스 문서 템플릿을 추가 또는 수정하려면

  1. Subversion 저장소에서 이 프로젝트에 대한 프로젝트 템플릿 디렉토리로 이동합니다.
    예를 들어 My-Project/trunk/www/cn-project-pages/Stages/Definition/templates
    로 이동할 수 있습니다. 여기서 My-Project는 프로젝트의 이름이고 cn-project-pages는 프로젝트 템플릿 디렉토리의 이름입니다.
  2. 기존 프로세스 문서 템플릿을 복사하고 새 파일로 저장합니다.
    예를 들어 Use-Case-template.doc를 편집할 수 있습니다.
  3. 파일을 로컬로 저장하고 기존 템플릿을 기준으로 새 템플릿을 생성할 경우 해당 파일에 새 이름을 지정합니다.
  4. 템플릿 파일을 편집하거나 이 파일을 기준으로 새 템플릿을 생성합니다.
  5. Subversion을 사용하여 기존의 프로세스 문서 템플릿을 교체하거나 새 프로세스 문서 템플릿을 해당 서브페이지나 페이지의 템플릿 디렉토리에 추가합니다.
    예를 들어 My-Project/trunk/www/cn-project-pages/Stages/Definition/templates/My-New-template.doc를 추가할 수 있습니다.
  6. 버전 제어 도구를 사용하여 변경 내용을 커밋합니다.
    프로세스 문서 템플릿은 해당 페이지의 적절한 섹션에서 프로젝트의 템플릿 페이지에 자동으로 추가됩니다.

반응형

관련글 더보기