Articles

못을 박는 소프트웨어 요구 사항 설명서

소프트웨어 개발할 수 있는 흥미 진진한 프로세스의 창의적 문제해결,디자인,엔지니어링입니다. 그러나 아래 반짝이는 앱과 광택 웹 페이지에 놓여 있지만 섹시 아직 oh-so-중요한 발판을 만드는 좋은 소프트웨어 결과를 가능:문서입니다.

문서를 보장하고 팀과 개인의 이해관계자들은 같은 페이지에서 제품에 대해 또는 소프트웨어 응용 프로그램의 목표,범위,제약,기능적 요구 사항입니다.불행히도 이러한 요구 사항을 작성하고 문서화하는 프로세스는 지루하고 혼란스럽고 지저분 할 수 있습니다.

소프트웨어 요구 사항 문서를 신속하게 될 수 있 긴 다루기 힘드,텍스트-무거운 문서를 만들고,그들은 특히 취약류,불일치,그리고 잘못된 해석. 이 때문에,쓰기,이 문서를 사용할 수 있는 시간이 많이 걸리고 비용이 발생(고 피할 수)디자인에 오류가 있습니다.

그렇다면 제품 관리자,소프트웨어 팀 및 비즈니스 리더는 무엇을해야합니까?

은 없지 one-size-fits-all 규칙 위한 소프트웨어 개발 접근 방법을 줄이는 방법에 대해 오류,시간을 절약하고 효과적인 결과를 제공합니다.

아래는 도보를 통해 목표와 혜택은 소프트웨어의 문서 요구 사항과 몇 가지 모범 사례에 도움이 될 것입니다 당신을 못하는 과정에서 시작하게 마무리합니다.

소프트웨어 요구 사항을 문서 템플릿
추천 구조물에 대한 SRD(이미지를 클릭하여 수정할인)

무엇이 있는 소프트웨어 요구 사항을 문서입니까?

소프트웨어 요구 사항을 문서(또는 소프트웨어 요구 사항을 명세이)는 문서 설정 또는 문서의 개요를 설명하는 특징 및 용도의 행동 소프트웨어 응용 프로그램입니다.

에 다른 단어,소프트웨어 요구 사항을 문서(SRD)에 대해 설명합 사업 또는 조직의 이해 최종 사용자(일반적으로 클라이언트)의 요구 사항 및 의존뿐만 아니라 어떤에 대한 제약 조건이 시스템입니다.

SRD 에는 무엇이 포함되어 있습니까?

srd 는 프로젝트의 범위를 관리하기위한 청사진으로 기능하지만 궁극적으로 시스템에 대한 기능 및 비 기능 요구 사항 만 정의합니다. 이 문서는 디자인이나 기술 솔루션을 간략하게 설명하지 않습니다. 이러한 결정은 나중에 개발자가 결정합니다.

잘 작성된 SRD 는 다음과 같아야합니다.

  • 문제를 관리 가능한 부분으로 나눕니다.
  • 테스트 및 검증을위한 참조 역할을합니다.
  • 알리는 디자인에 사양(즉,SRD 요구를 포함한 충분한 정보의 요구 사항에는 소프트웨어 렌더링하기 위해 효율적인 디자인이다).
  • 클라이언트(최종 사용자)에게 피드백을 제공합니다.

SRD 을 보여 클라이언트는 귀하의 조직을 이해한 문제점들을 해결하는 방법과 이러한 문제를 해결을 통해 소프트웨어 솔루션입니다. 기 때문에 클라이언트는 자주 직접적인 이해관계자,특히 중요한 초안은 설명서에서 명확하게 평신도의 조건(피하고 기술적인 전문 용어).

다시 말하지만,SRD 를 작성하는 방법은 팀이나 조직이 구독하는 접근 방식과 방법론에 달려 있습니다. 그러나,IEEE 표준은 조직이 추천 전형적인 SRDs 해야는 다음과 같은 항목이 포함됩니다:

  • 인터페이스
  • 기능
  • 성능 수준
  • 데이터 구조/요소
  • 안전
  • 신뢰성
  • 보안/개인정보 보호정
  • 품질
  • 제약 조건 및 제한 사항

는 경우 이러한 각각의 항목은 명확하게 해결과에서 설명하는 문서,당신은 더 많은 완전한 그림을의 정보를 개발하는 데 필요한 응용 프로그램입니다.

는 방법을 못하는 소프트웨어 요구 사항을 문서로

어떤 방법을 설명서에 따라 이러한 모범 사례를 만들이 효과적이고 효율적인 SRD.

조직 유지

게임의 이름은 조직입니다. 시작하기 전에 당신은 실제로 문서화하는지 확인을 시작으로 조직의 전략에 대한 모든 문서 등의 문서 저장되는 방법,일관성을 보장하기 위해,그리고 어떻게 기여자와 공동 작업자를 유지할 수 있습 문서를 그대로–날짜입니다. 효과적이기 위해서는 소프트웨어 요구 사항 문서를 정리하고 명확해야합니다. 많은 조직이 프로젝트 전반에 걸쳐 일관성을 유지하기 위해 집 템플릿에 의존합니다. 템플릿을 절약 할 수있는 좋은 방법은 시간(다만 채웁니 pre-조직 섹션)고 일관성 설명서의 과정입니다.

그러나 문서 템플릿을 자주 강화 문제의 장황한,텍스트-무거운 요구 사항입니다. 텍스트의 페이지에서 수렁에 빠지지 않으려면 시각적 데이터로 문서화 프로세스를 보완하는 것이 좋습니다.

Lucidchart 문서를 들어
어떻게 Lucidchart 팀은 사용되는 순서도를 위한 소프트웨어 설명서를 참조하십시오!

지 확인 요구 사항은 완전한

에 대한 요구 사항을 완료”,”그것은 포함해야하는 데 필요한 모든 정보를 구현 요구 사항입니다. 즉,설계자와 개발자가 함수를 빌드하기 위해 갈 때 요구 사항에 대한 가정이나 추측을 남기지 않습니다.예를 들어 웹 페이지를 개발한다고 가정 해 봅시다. 설명 된 요구 사항 중 하나는 오류 발생시 발생해야하는 작업입니다. 불완전한 요구 사항 같은 것을 말할 수 있습니다”오류가 발생한 경우에,시스템을 종료해야 원활하게.”

이 경우”부드럽게”는 정의되지 않고 해석까지 남습니다. 이 모호성은 원하는 결과에 대한 오해로 이어질 수 있습니다(그리고 돌아가서 수정하기위한 더 많은 작업).

,이를 방지하기 위해 작성 완전한 요구 사항을 정의하는 무엇이 성공적인 함수는 다음과 같습니다:

“오류가 발생한 경우에,이 시스템은 오류가 표시지와 함께 다음 메시지가 표시됩니다.

Uh-oh! 뭔가 잘못 된 것 같습니다. 몇 분 안에 다시 시도하십시오. 문제가 계속되면,우리의 지원 팀에 문의하십시오 [email protected].”

정의하여 완전한 요구 사항이 모호성을 줄이고 명확한 결과를 위해 개발 팀에서 작동 합니다.

확인 요구 사항을 검사할 수 있

이것은 매우 유비쿼터스 기준,그러나 너무 자주하지 못하는 조직이 작성 요구 사항을 완전히 만나 이 규칙이 있습니다.요구 사항을 검증 할 수 있어야합니다. 그렇지 않으면 요구 사항이 만족스럽게 구현되었는지 여부를 알 수있는 객관적인 방법이 없습니다.

을 위해 모든 요구 사항은 당신이 쓰지 확인을 통해 유효성을 검사 중 하나 이상의는 다음과 같은 방법으로.

  • Inspection
  • 데모
  • 보를 통하여

높은 수준의 요구 사항을 수시 검사를 받아야 또는 사용자 테스트,그래서 그들은 일반적으로에 의존하고 보다 일반적인 사양입니다. 그러나 소프트웨어 테스트를받는 낮은 수준의 요구 사항은 더 자세한 사양이 필요할 가능성이 큽니다.

구현 중립적 인 기능 요구 사항 적용

앞에서 언급했듯이 SRD 는 설계 문서가 아닙니다. 디자인 관점에서 기능 요구 사항을 구현해야하는 방법을 정의하지 않으며 정의하지 않아야합니다.따라서 모든 기능 요구 사항은 구현 중립적이어야합니다. 즉,요구 사항은 시스템이해야 할 일을 명시해야하지만 어떻게해야하는지는 명시해야합니다.

다음을 포함하여 구현 중립적 인 요구 사항에는 몇 가지 이점이 있습니다:

  • 더 효율적인 디자인 프로세스가
  • 요구 사항을 수정할 수 있는지에 따라 특정 설계를 구현하는
  • 덜 사이의 갈등 요구 사항 결과는 반대에서 구현 세부 사항

어떤 제약 조건에 구현 예약해야에 대한 비 기능적 요구 사항의 시스템입니다.

가 평가 설명서와 함께 이해관계자

경우 모든 소프트웨어 요구 사항을 문서화,모든 관련 이해 관계자를 평가하는 최종 문서를 개발하기 전에 시작됩니다.

이해관계자를 포함해야 한 디자이너와 개발자,테스터는 것이 확인 요구 사항,엔지니어,최종 사용자 대표,그리고 클라이언트입니다.

함으로써 모든 이해 관계자를 검토하고 승인하기 전에 문서를 처음 개발,당신은 만족도 향상 전 팀과 확률을 증가하는 요구조건을 만나 그들의 필요합니다.

도움이 소프트웨어 개발자 및 그들의 팀과 동일한 페이지와 함께 하는 순서도 효율적이고 우아하게 지도하는 소프트웨어 요구 사항의 사양입니다. 당신을 도울 수있는 다이어그램 솔루션을 찾으십시오:

  • 요구 사항을 플로우차트로 구성하여 구성 요소를 뚜렷하게 유지하고 종속성을 명확하게하며 이해 관계자를 분명하게 유지합니다.
  • swimlanes 를 사용하여 각 요구 사항 세트를 담당하는 팀을 시각적으로 설명합니다.
  • 프로젝트 요구가 발전함에 따라 요구 사항이나 기타 데이터를 신속하게 수정합니다.
  • 데이터(추가 문서 포함)를 연결하여 진행중인 프로젝트를 지원하고 알립니다.
  • 문서(및 변경 사항)를 관련 이해 관계자와 즉시 공유하십시오.

문서는 자질구레 한 일이 될 필요가 없습니다. Lucidchart 를 사용하면 프로세스,사용자 스토리 및 소프트웨어 요구 사항을 한 곳에서 쉽게 문서화 할 수 있습니다. 에 의해 시각적으로 정의하는 귀하의 요구 사항의 사양,당신과 당신의 팀을 찾을 수있을 것입과 행동에 대한 정보를 신속을 줄이는 동시에 기회에 오류가 있는 불일치,그리고 잘못된 해석.

시작 문서화

에 대한 가시성을 확보하고 기존 기술 시스템으로 Lucidchart 오늘입니다.

방법을 배우십시오