Teacher Song’s software quality junior training camp has been completed. The second phase of the school has been opened. There are many questions raised by the students in the group. Some questions can be answered directly in the group. Some common tweets can be written into tweets for students and fans to learn. You are also welcome to leave a message to supplement. What granularity should the product requirements be written to?
Product requirements document core function is to communicate information. Face-to-face communication is definitely the best effect, but human memory will attenuate, and the information processing capacity per unit time is also limited, so documents are needed to record it, and the information receiver can smoothly understand and correctly carry out the next step of work through structured and standardized expressions.
So, the granularity to be written may vary from company to company to team, but I have summarized two basic principles:
- The relevant parties who need to use this document can correctly carry out the next work through document information; for example, designers are used to design architecture, testers are used to design test case , and future people who maintain products quickly understand the structure of the product.
- The granularity required by this product can be verified by testing. In principle, all requirements need to be verified, and whether they can be verified also indirectly illustrates that the clarity and evaluability of the requirements description can be transparent and controllable.
However, in actual engineering practice, different granularities may coexist in one document, some requirements will be coarse granularity, and some will be fine granularity. For example, if the requirements are improved products, the part that everyone is familiar with can be written in a coarse grain; the parts that are not familiar with should be more fine grained. In the future, if there may be small changes, the coarse grain size may be large; in addition, depending on the quality of different executives, the quality can be high, the coarse grain size can be a little bit, but if the quality is insufficient, the management and control need to be strengthened, the fine grain size is needed.
Overall,
Coarse granularity
The advantages are that the cycle is short, the maintenance is strong, and it can quickly deal with frequent changes and have high flexibility;
Disadvantages: It is difficult for people who take over the later stage to maintain and use it.
Fine-grained size
Advantages: Easy to evaluate and control, and facilitate accurate planning.
Disadvantages: It leads to long document writing cycles and poor maintainability of changes.
So, what size is written to be? It still needs to be reasonably determined based on the actual situation of the project.
End
