Điều gì tạo nên một đặc điểm kỹ thuật tuyệt vời?

Question

Những phẩm chất nào đã làm cho nó trở nên tuyệt vời và điều gì làm cho nó nổi bật so với các thông số kỹ thuật không tuyệt vời mà bạn phải đối phó? Hoặc, nếu bạn chưa bao giờ làm việc với một đặc tả chức năng tốt trước đây, bạn sẽ mong đợi điều gì trong một thông số tuyệt vời? Xin lỗi điều này rõ ràng là chủ quan nhưng tôi đang tạo ra một đặc tả chức năng (không phải của tôi đầu tiên) và nó chỉ xảy ra với tôi rằng tôi có thể nhận được một số ý tưởng tốt từ những người sáng trên SO!

Answer 1

Thông số kỹ thuật Project Aardvark từ Joel trên phần mềm là tốt nhất mà tôi đã gặp cho đến nay. Mỗi màn hình được xác định rất tốt, với hình ảnh. Các tính năng chính của phần mềm được mô tả, cũng như một số chi tiết kỹ thuật.

Đáng buồn là các thông số kỹ thuật tôi nhận được cá nhân không phải là điều tuyệt vời. Thông thường, họ chỉ là một danh sách các tính năng mà họ mong đợi từ mỗi phần của hệ thống, và họ hy vọng bạn làm việc ra tất cả các chi tiết. Đó là tốt, tôi đoán. Tuy nhiên, tôi đang viết một tài liệu thiết kế trò chơi cho một trò chơi RPG tôi đang làm việc như một dự án cá nhân, và tôi nghĩ rằng các thông số kỹ thuật tôi đang viết rất tốt bằng văn bản. Tôi đã chia các trò chơi vào mục như

• Nhân vật
• Weapons & Armor
• Mức
• Bản đồ
• Vật lý

và vân vân, và mô tả từng bộ phận trong các điều khoản của trò chơi cũng như một số chi tiết kỹ thuật. Nó rất dễ dàng để làm việc thông qua.

Tôi cũng khuyên bạn nên đọc Painless Functional Specs Series từ Joel on Software cho bất kỳ ai quan tâm đến việc viết thông số kỹ thuật tốt hơn.

Answer 2

Rõ ràng, đặc tả phải đầy đủ, nhất quán và dễ hiểu. IMO nó cũng nên được tổ chức tốt, trong đó nó giữ tất cả các yêu cầu cho một phần cụ thể của sản phẩm với nhau. Tôi đã đọc chi tiết kỹ thuật nhiều lần khi yêu cầu đối với một số mô-đun được phân tán trong toàn bộ tài liệu, ví dụ: mô tả chung nằm trong chương 4, nhưng các yêu cầu bổ sung có thể được tìm thấy trong các khoản 2, 5, 7 và phụ lục B. Để làm việc với đặc điểm kỹ thuật như vậy, trước tiên tôi phải tạo một bản đồ tham chiếu chéo các yêu cầu cho các mô-đun.

Answer 3

IMHO, chất lượng chính phải là thông số chức năng chỉ định chi tiết "cái gì" nhưng không phải là "cách". Bằng cách đó, người yêu cầu (tiếp thị?) Có được cái nhìn cảm nhận và tính năng thiết lập mà họ muốn, nhưng việc thực hiện được để lại cho những người biết điều đó tốt nhất - các nhà phát triển.

Answer 4

Một thông số tốt nên nêu rõ ứng dụng được yêu cầu làm gì, theo cách rõ ràng.

Điều này có vẻ hiển nhiên, nhưng những thứ tôi thường nhận được thường rất mơ hồ. Dường như không dễ để mọi người thể hiện những gì họ muốn trên giấy, NẾU họ thậm chí biết họ muốn gì.