Những điều nên và không nên khi viết yêu cầu

Làm #1. Cùng một lúc - Mỗi yêu cầu nên được coi như một trường hợp kiểm thử rời rạc. Không nên sử dụng các liên từ như và, hoặc, v.v. vì chúng có thể dẫn đến việc bỏ sót các yêu cầu. Điều này đặc biệt quan trọng vì các điều khoản như thế này có thể khiến các nhà phát triển phần mềm và người kiểm tra bỏ qua các yêu cầu. Chia các nhu cầu phức tạp thành các phần nhỏ hơn cho đến khi từng phần có thể được kiểm tra riêng biệt là một cách để ngăn điều này xảy ra.

Đừng #1. Nói “Cái gì” chứ không phải “Làm thế nào” - Trọng tâm nên tập trung vào những gì hệ thống sẽ làm, không phải là cách nó thực hiện. Ngoài ra, tránh đi quá sâu vào các chủ đề thiết kế như tên trường, đối tượng ngôn ngữ lập trình và đối tượng phần mềm. Nếu bạn thấy mình đang thảo luận về những chủ đề này trong Tài liệu Đặc tả Yêu cầu, hãy lùi lại một bước - điều này có thể có nghĩa là bạn đang trở nên quá cụ thể.

Làm #2. Truy xuất nguồn gốc - Truy xuất nguồn gốc trong quản lý dự án đề cập đến việc đảm bảo rằng các yêu cầu được liên kết với các thành phần khác trong dự án. Điều này cho phép người quản lý dự án, nhà phát triển và các bên liên quan theo dõi toàn bộ vòng đời của yêu cầu từ đầu đến cuối theo mọi hướng cũng như với các phần khác của hệ thống. Nếu bạn quản lý khả năng truy xuất nguồn gốc đúng cách, bạn có thể tránh mã không tương ứng với bất kỳ yêu cầu nào (mã 'đi lạc') và đảm bảo rằng mọi trường hợp thử nghiệm đều bao gồm ít nhất một yêu cầu. Bạn có thể truy xuất nguồn gốc các yêu cầu bằng cách gắn nhãn chúng với một số nhận dạng duy nhất và cung cấp thông tin về nguồn của chúng trong một kho lưu trữ trung tâm mà tất cả các thành viên trong nhóm đều có thể truy cập được.

Đừng #2. Không có ngoại lệ - Một yêu cầu không được có điều khoản thoát. Ví dụ: “Hệ thống sẽ xác định số lần đăng nhập, ngoại trừ khi người dùng đã nhập sai tên người dùng rõ ràng”.

Làm #3. Khả thi – Đảm bảo rằng ngân sách và thời gian của dự án là khả thi, cùng với các nguồn lực sẵn có. Nếu điều kiện này có thể hỗ trợ yêu cầu, thì có thể tiến hành kế hoạch.

Đừng #3. Nói Không với các điều khoản “cho ra ngoài” - Cố gắng tránh xa các cụm từ dễ hiểu như nhưng, ngoại trừ và chỉ khi cần thiết.

Làm #4. Tính nhất quán - Duy trì mức độ chi tiết nhất quán. Ví dụ: đối với các yêu cầu của người dùng, người dùng cuối phải là chủ thể của mọi câu. Tương tự, đối với các yêu cầu về hệ thống, hệ thống phải là chủ đề của mọi câu.

Đừng #4. Không có chữ viết tắt - Mọi yêu cầu phải là một câu đầy đủ mà không có bất kỳ từ viết tắt hoặc biệt ngữ nào.

Làm #5. Giọng nói hoạt động - Luôn viết với giọng chủ động, đảm bảo rằng một trong những diễn viên là chủ đề của mỗi câu.

Đừng #5. Đừng mập mờ – Không sử dụng các thuật ngữ mơ hồ như khoảng, v.v.và nhiều thuật ngữ tương tự như vậy trong tài liệu yêu cầu. Đảm bảo giải thích các yêu cầu theo cách mà mọi người liên quan đều hiểu chúng một cách chính xác. Tuyên bố mơ hồ có thể dẫn đến hiểu sai và có thể gây ra xung đột giữa các bên liên quan khác nhau.

Làm #6. Chủ ngữ & Vị ngữ - Đối với mọi yêu cầu, phải có chủ ngữ (người dùng / hệ thống) và vị ngữ (kết quả dự kiến, hành động hoặc điều kiện).

Đừng #6. Suy đoán có thể gây ra thiệt hại - Đừng đoán; không lập danh sách các tính năng nằm ngoài câu hỏi. Nói rằng bạn muốn một hệ thống xử lý tất cả các lỗi không mong muốn là điều hoàn toàn tưởng tượng vì không có hệ thống nào giống 100% những gì bạn mong muốn. Tránh các câu nói trùng lặp và mâu thuẫn.

Làm #7. Kiểm chứng - Một điều khác cần lưu ý khi tổ chức các yêu cầu là chúng phải luôn có thể kiểm tra được. Điều này có nghĩa là cần có khả năng xác minh hệ thống đáp ứng yêu cầu được đề cập. Điều này cũng liên kết đến điểm tiếp theo của chúng tôi - truy xuất nguồn gốc. Nếu một yêu cầu chứa đầy các thuật ngữ mơ hồ, thì việc phân tích và xác minh xem hệ thống có thực sự đáp ứng các tiêu chuẩn này về Hiệu suất hay không sẽ trở nên khó khăn hơn. Do đó, càng nhiều càng tốt, hãy nhắm đến sự rõ ràng và chính xác trong ngôn ngữ của bạn để việc thu thập Yêu cầu không phải là một quá trình mơ hồ.

Đừng #7. Tránh các tùy chọn - Không đưa ra ý tưởng hoặc lựa chọn. Bạn có thể phát hiện những điều này trong bất kỳ câu lệnh nào bao gồm các cụm từ có thể, có thể, có thể, hoặc nên.

Làm #8. Chính xác - Đảm bảo rằng mỗi câu đều hoàn chỉnh và đúng ngữ pháp với chủ ngữ, động từ và vị ngữ thích hợp.

Đừng #8. Đừng nói chuyện trong thì tương lai - Không đề cập đến một yêu cầu chưa được xác định. Mục tiêu của bạn là làm cho tài liệu dễ đọc nhất có thể.

Làm #9. Tập trung - Thiết lập sự tập trung bằng cách loại bỏ các cụm từ lan man, quá dài và các tham chiếu đến các bài báo lỗi thời.

Đừng #9. Những gì nên được sử dụng và ở đâu? - “Sẽ” nên được sử dụng khi các yêu cầu được nêu rõ, “Ý chí” nên được sử dụng để thể hiện các tuyên bố về sự kiện; & “Nên” để thể hiện một mục tiêu cần đạt được.

Làm #10. Thủ tục giấy tờ có tổ chức làm điều kỳ diệu - Giữ các yêu cầu được sắp xếp ở một nơi để cải thiện khả năng đọc tài liệu của bạn và tránh lãng phí thời gian tham khảo chéo nhiều nguồn.

Đừng #10. Không sử dụng thuật ngữ không xác định – Không sử dụng các thuật ngữ không xác định như “thân thiện với người dùng, linh hoạt và mạnh mẽ” vì có thể gây khó khăn khi cố gắng xác định các trường hợp thử nghiệm. Những từ này thường mang những ý nghĩa khác nhau đối với những người khác nhau.