知识卡片

普通读书笔记卡 · 5611.a

需求文档先说明目标和语境

理解等级:初级

把想法写下来能暴露遗漏,但文档必须在合适层次说明要解决什么问题、服务谁、边界和成功标准,而不只是把实现逐行翻译成自然语言。

大量配置说明不能替代系统用途和组成关系,页数也不等完整性。实现细节可以记录,只是不能冒充需求定义。

这张卡片看不懂?

已有反馈 · 0 / 10 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    • 15.5 项目设计 · 查看原书依据

      谈论你要做什么,而不是怎么做。 举一个例子,有一次我被要求帮助设计一个血压计。客户给我寄来了大约5 000页的文件,要求我估算一下成本,我没能做到。由于之前的问题,公司管理层发布了一条规定,没有文档就不能编写代码。这听起来很好,但管理层忽视了一个事实:员工们都

    参考来源

    - 位置:《计算机系统解密》15.5 项目设计(来源项目book-sources,源文件:extracted/计算机系统解密/_epub-src/text/part0150.html) - 结论依据:本项全部正文与图表实际读取,区分作者示例、推导与实现边界;纠错另有明确说明。 - 原始内容:谈论你要做什么,而不是怎么做。 举一个例子,有一次我被要求帮助设计一个血压计。客户给我寄来了大约5 000页的文件,要求我估算一下成本,我没能做到。由于之前的问题,公司管理层发布了一条规定,没有文档就不能编写代码。这听起来很好,但管理层忽视了一个事实:员工们都