如何編寫技術要求

Question

在應用程序中編寫UI組件的技術要求的正確方法是什麼？我想我不清楚技術要求是應該如何實現UI還是應該儘可能通用，並描述滿足功能需求和忘記實現細節所需的內容。

這裏是我的具體問題：

• 它應該註明哪些技術用戶界面將在實施？ （例如，ActiveX，WPF，HTML）。

• 我應該描述佈局，顏色？ （因爲這可以改變）

• 是否有必要描述數據是如何呈現的？ （例如，是否需要說「數據以表格或列表格式顯示」或「滾動條應顯示數據無法在屏幕上顯示」？）

• 我是否需要描述UI如果這是功能要求，對用戶輸入做出反應？ （例如，功能要求說明「用戶應該清楚哪些動作當前處於活動狀態」......技術要求應該說「當用戶選擇選項a時，該按鈕應將顏色更改爲紅色......用戶選擇選項b時藍色.. etc「）

• 是否有必要陳述關於UI的常識？例如，「它應該是整個內容可見的位置」？或「它應該有影子，以便從屏幕的其餘部分突出」？ （注意：這些不是功能要求，但它們通常適用於任何UI）

Answer 1

這裏沒有具體的規則。真正的答案是，它取決於你的團隊組成。

• 如果撰寫要求的人是技術負責人，那麼它可能會決定技術選擇。
• 但是，如果撰寫要求的人是非技術性經理，那麼讓技術團隊決定具體細節通常是最有利的，而經理只是規定必須實施的具體要求。
• 此外，像佈局和顏色的東西可能沒有在技術要求的地方。有人（無論是開發團隊還是設計師）都應該提供模型或線框來與用戶一起審覈。這是一個迭代過程，通常可以與一些最初的開發並行完成（即，開發人員通常可以開始編寫域模型，數據庫模式等，而設計人員與用戶/利益相關方迭代UI）。
• 國際海事組織，明顯的事情應該被排除在外，因爲它們只是混亂，然而，諸如驗證和屏幕狀態等業務規則應該絕對。

同樣，我想重申它完全取決於團隊的構成。需求文檔是爲了從一層到另一層進行通信。所有的決定都應該留給那些做出最佳決策的層級。