如何编写技术要求[关闭]

Question

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

这是我的具体问题：

• 是否应说明 UI 将采用何种技术实现？ （例如，ActiveX、WPF、HTML）。

• 我应该描述布局和颜色吗？ （鉴于情况可能会改变）

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

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

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

Answer 1

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

• 如果编写需求的人是技术主管，那么它很可能决定技术选择。
• 但是，如果编写需求的人是非技术经理，那么让技术团队决定具体细节，而经理只规定必须实施的具体要求，通常最符合最佳利益。
• 此外，布局和颜色之类的东西在技术要求中可能没有一席之地。有人（无论是开发团队，或者如果有的话，设计师）应该拿出模型或线框图与用户一起审查。这是一个迭代过程，通常可以与一些初始开发并行完成（即，开发人员通常可以开始编写域模型、数据库架构等，而设计人员则与用户/利益相关者一起迭代 UI）。
• IMO，明显的东西应该被排除在外，因为它们只是杂乱无章，但是，验证和屏幕状态等业务规则绝对应该。

我想再次重申，这完全取决于团队的构成。需求文档旨在从一层到另一层进行通信。并且所有决定都应该留给最有能力做出这些决定的层。