zoukankan      html  css  js  c++  java
  • Recommend for Reviewing design doc-from How Google Test Software

    Below paragraph is from <How Google Test Software>, I do think it's a good reference for us. Some rules also can be applied for other document review, for example, on specifications.  


    “Reviewing design documents should be done with purpose and not just

    be a general breeze through, as though you are reading a newspaper. A good
    SET is purposeful during his review. Here are some things we recommend:

    • Completeness: Identify parts of the document that are incomplete or
    that require special knowledge not generally available on the team, particularly
    to new members of the team. Encourage the document’s
    author to write more details or link to other documentation that fill in
    these gaps.

    Correctness: Look for grammar, spelling, and punctuation mistakes;
    this is sloppy work that does not bode well for the code they will write
    later. Don’t set a precedent for sloppiness.

    Consistency: Ensure that wording matches diagrams. Ensure that the
    document does not contradict claims made in other documents.

    Design: Consider the design proposed by the document. Is it achievable
    given the resources available? What infrastructure does it propose
    to build upon? (Read the documentation of that infrastructure and
    learn its pitfalls.) Does the proposed design make use of that infrastructure
    in a supported way? Is the design too complex? Is it possible to
    simplify? Is it too simple? What more does the design need to address?

    • Interfaces and protocols: Does the document clearly identify the protocols
    it will use? Does it completely describe the interfaces and protocols
    that the product will expose? Do these interfaces and protocols accomplish
    what they are meant to accomplish? Are they standard across
    other Google products? Can you encourage the developer to go one
    step further and define his protocol buffers? (We discuss more about
    protocol buffers later.)

    • Testing: How testable is the system or set of systems described by the
    document? Are new testing hooks required? If so, ensure those get
    added to the documentation. Can the design of the system be tweaked
    to make testing easier or use pre-existing test infrastructure? Estimate
    what must be done to test the system and work with the developer to
    have this information added to the design document.”

  • 相关阅读:
    QT编译时 cc1plus进程占用大量内存卡死问题解决
    python import cv2 出错:cv2.x86_64-linux-gnu.so: undefined symbol
    python ImportError: No module named builtins
    OSError: libcudart.so.7.5: cannot open shared object file: No such file or directory
    二维数组和二级指针(转)
    C/C++中无条件花括号的妙用
    C语言中do...while(0)的妙用(转载)
    卸载 ibus 使Ubuntu16.04任务栏与启动器消失 问题解决
    关于Qt creator 无法使用fcitx输入中文的问题折腾
    QT error: cannot find -lGL
  • 原文地址:https://www.cnblogs.com/isister/p/4540052.html
Copyright © 2011-2022 走看看