什么样的文档是良好的需求文档

lasthuhu

[em6] [em7]

     RT,被主策批评很多次了。说我把需求文档写成了实现文档，做了程序该做的事情。
     我知道自己的文档写的哈烂，贴一小段，请大家帮忙指正下吧。

     刷新流程即创建Npc对象的流程，可以表述如下:
     根据Npc配置表约定，对每一个刷新点，有一个绑定的Npc对象，该绑定Npc对象所属Npc类对应类编号属于特定组。
     对刷新点进行轮询，判断对于该刷新点，当前是否存在与该刷新点绑定的Npc对象或尸体对象；
     如果是，则不作任何行为；
     如果否，则经过延时T，在该刷新点产生Npc对象。

mapzi

这东西就象是吃鸡蛋,有人喜欢吃生的,有人喜欢吃煮的,有人喜欢吃咸的.有的程序喜欢你把文档具体的甚至到代码怎么写,有的就只喜欢你告诉他实现什么功能,与其问什么样的文档是良好的文档,与问鸡蛋怎么吃好吃道理一样.如果你想顺着你们主策的思路 来,那就拿过他的文档来看看就OK了.

lasthuhu

。。。 [em6]

小树

需求文档
我现在要买一双鞋，这双鞋要多少尺码，什么颜色，什么牌子，什么时候要。

spy

功能需求，你需要哪些参数，需要哪些算法，需要哪些调用和函数。这些需求是如何组合的，开发难点在哪里，为什么要这么设计，等等

ui细节，你需要几个按钮，几个图片，每个资源各自是多大，需要什么特殊定义，需要什么颜色，需要什么坐标。

lasthuhu

主要是我做的东西，不涉及实现感觉非常难提需求。
比如我以前做的任务系统，和现在做的AI。最后东西是做出来了，但是程序意见很大，说我们这边把东西都定死了。

lasthuhu

spy: Re:什么样的文档是良好的需求文档

功能需求，你需要哪些参数，需要哪些算法，需要哪些调用和函数。这些需求是如何组合的，开发难点在哪里，为...

我们主策不喜欢这样的文档风格 [em6]
这和我以前师傅的要求正好相反，真痛苦啊。
要是我文档再写成实现文档的话，项目经理就要找我谈心了 [em11]

spy

那么。。。想问问你主策说的“需求”是指啥？

lasthuhu

恩，他给我个mmap图，让我把mmap图上的模块实现出来。

suquan77

估计是只说“有什么”

这个功能可以有什么操作，需要做什么判断，然后就到此为止……