如何编写技术要求

Question

在应用程序中编写UI组件的技术要求的正确方法是什么？我想我不清楚技术要求是否应该规定UI应该如何实现，或者它应该尽可能通用，并描述满足功能要求所需的内容并忘记实现细节。

以下是我的具体问题：

• 它应该说明UI将在哪种技术中实现？ （例如，ActiveX，WPF，HTML）。

• 我应该描述布局，颜色吗？ （鉴于可以改变）

• 是否有必要描述数据的呈现方式？ （例如，是否需要说“数据以表格或列表格式显示”或“滚动条出现是否数据无法在屏幕上显示”？）

• 我是否需要描述UI如何对用户输入做出反应（如果这是功能要求）？ （例如，功能要求说“用户应该清楚哪个动作是当前活动的”......如果技术要求说“当用户选择选项a时按钮应变为红色。当用户选择选项b时，蓝色将变为红色..等等“）

• 是否有必要陈述关于UI的常识？例如，“它应该以这样的方式定位整个内容是否可见”？或“它应该有阴影，以便它从屏幕的其余部分突出”？ （注意：这些不是功能要求，但它们适用于任何UI）

Answer 1

这里没有具体的规则。真正的答案是，这取决于你的团队是由什么组成的。

• 如果撰写要求的人是技术主管，那么它可能决定了技术选择。
• 然而，如果编写要求的人是非技术经理，那么让技术团队决定具体细节通常最符合最佳利益，而经理只是规定必须实施的具体要求。
• 此外，布局和颜色等内容可能无法满足技术要求。某人（无论是开发团队，还是设计人员）都应该提供模型或线框来与用户一起审核。这是一个迭代过程，通常可以与一些初始开发并行完成（即开发人员通常可以开始编写域模型，数据库模式等，而设计人员则与用户/利益相关者一起迭代UI）。
• IMO，显而易见的事情应该被排除在外，因为它们只是混乱，但是，验证和屏幕状态等业务规则应该是绝对的。

同样，我想重新审视它完全取决于团队的构成。需求doc旨在从一个层到另一个层进行通信。并且所有决定都应留给最有能力做出决定的等级。