Định dạng chung của Đặc tả thiết kế phần mềm là gì?

Tôi đang cố gắng ghi lại một phần mềm mà tôi đã viết chi tiết. Một SAS quá cao và không bao gồm API. Tôi đã tìm thấy một số ví dụ về SDS trực tuyến, nhưng tôi không thấy xu hướng trong định dạng của chúng.

Tôi đang tự hỏi liệu có một số hướng dẫn chung để viết một Đặc tả thiết kế phần mềm hay cách tiếp cận tốt nhất là gì?

Bạn có thể làm điều tồi tệ hơn nhiều so với việc bắt đầu với Mô tả mục dữ liệu tài liệu thiết kế phần mềm DOD-STD-2167A .

Bộ Quốc phòng Hoa Kỳ có nhiều kinh nghiệm về phát triển phần mềm, nhiều hơn bất kỳ công ty nào. Họ cũng có quyền lợi trong việc thực sự có được phần mềm thực hiện công việc và điều đó có thể được duy trì trên đường. Họ đã gặp rất nhiều rắc rối để tìm ra thông tin nào cần có trong các tài liệu khác nhau hỗ trợ cho một dự án phần mềm, sử dụng kinh nghiệm từ một số lượng lớn các dự án và hơn một vài thất bại rất tốn kém.

Kế hoạch phát triển phần mềm DID (có sẵn tại đây ) bao gồm một số mục phải được giải quyết. Nếu bạn nhìn kỹ, bạn sẽ nhận thấy rằng những phần đó được viết bằng máu của những người quản lý chương trình đã không giải quyết được những mục đó.