기능명세서 예제

기술 사양 단계에서 기능 설계 및 구현에 대한 합의에 도달한다는 것은 위기 상황에서 기능을 출시하려고 할 때 매우 중요한 방식으로 진행되는 경합을 줄인다는 것을 의미합니다. 출시 후 기술 사양은 이해 관계자가 특정 구현 결정이 내려진 이유, 프로젝트 범위가 무엇인지, 다른 플랫폼 및 서비스와 통합하는 방법 등 정확한 정보를 신속하게 찾을 수 있는 유용한 참조 가이드 역할을 합니다. 팀이 몇 주 동안 사용해 온 새로운 기능을 시작하려고 합니다. 스테이징에서 확인하려고 하면 예상대로 작동하지 않습니다. 문제를 자세히 설명한 후 기능이 다른 팀에서 최근에 더 이상 사용되지 않은 서비스에 의존한다는 것을 알게 됩니다. „목표가 아닌”의 개념은 직관적이지 않고 혼란스러울 수 있습니다. Lyft의 내부 기술 사양 가이드에서 정의하는 방법은 다음과 같습니다. 목표가 아닌 것을 정의하면 프로젝트 범위를 제한하고 기능 크리프를 방지하는 데 도움이 됩니다.” 목표와 마찬가지로 비골도 눈에 띄게 읽을 수 있어야 합니다(글머리 기호 를 제안합니다). 기술 사양에 비목표를 깊이 묻는 것은 사실상 캐주얼 리더가 프로젝트 범위를 넓히려고 노력할 것입니다.

각 사양은 위키 페이지에 기록됩니다. 당신은 무엇을 설명합니까? 어떤 수준의 요구 사항이 최적입니까? 다음은 개발자, 테스터 및 비즈니스 이해 관계자가 😉 감사할 좋은 사양을 작성하기 위한 몇 가지 제안사항입니다. 프로젝트의 위험을 강조하는 것은 불안을 유발할 수 있습니다. 검토자가 시스템 / 제품에 이 모든 위험을 도입한 것에 대해 비판한다면 어떨까요? 그래도 검토자가 궁극적으로 기능을 더욱 강력하게 만드는 질문과 해결책을 제기할 수 있도록 이러한 비판을 요청하는 것이 중요합니다. 사양을 작성하는 것은 엄격함, 창의성 및 겸손의 이상한 혼합을 필요로하지만, 당신이 충분한 열정을 넣어 제공, 접근하기 쉬운 매우 보람있는 운동이다! 어떤 방법으로 선택하든, 최상의 사양은 소프트웨어 생산 프로세스를 용이하게 하는 사양이라는 점에 유의하십시오. 일부 개발자는 궁호이며 기능 사양 문서의 바로 그 아이디어를 비웃을 것입니다. 다른 사람들은 하나없이 신선한 코드의 줄을 입력하지 않습니다. 기능 요구 사항 사양은 전체 팀의 참조 문서역할을 합니다. 제품 개발자가 개발해야 하는 제품, 테스터가 테스트해야 하는 것, 작성자가 문서화해야 하는 것, 영업 사원이 판매할 제품을 보여줍니다.

서면 기능 사양은 개발이 시작되기 전에 디자인과 의도를 철저히 고려되었음을 보여줍니다. 또한 사양 승인 후 모든 이해 관계자가 동일한 페이지에 있음을 보여 줍니다. 제품이 코딩된 후 문서를 채우기 위해 사양을 작성해서는 안 됩니다. 경력 초기에 저는 프로젝트, 프로젝트 팀, 열린 문제, 환경, 가정, 종속성, 제약 조건, 주요 날짜, 비즈니스 모델, 데이터 요구 사항에 대한 정보를 포함하는 50 페이지 이상의 소프트웨어 요구 사항 사양을 만드는 경향이 있었습니다. 그리고 마지막으로 기능 적 요구 사항. (기능 요구 사항은 일반적으로 이러한 긴 문서의 10-15 페이지를 제외한 모든 부분을 차지했습니다.) 이 문서들은 철저했지만, 그들은 펑크가 부족했다. 또한 사양에 따라 일관되게 이름을 지정합니다. 예를 들어 해당 단추를 어딘가에 „유효성 검사 단추”라고 부르고 다른 곳에서는 „확인 단추”라고 부르지 마십시오.