Re: How much requirement documentation up front?

From: Phlip (phlip_cpp_at_yahoo.com)
Date: 10/22/04


Date: Fri, 22 Oct 2004 14:30:08 GMT

Sylvain wrote:

> Hi, earlier this week I posted a question regarding RUP and how much spec
> must be done at the end of the Elaboration phase (see below for original
> post). I was quite surprised to see so few replies. I will rephrase my
> question to make it broader and nonn-RUP specific:

> Question: In an iterative development process where formal requirements
are
> written, as opposed to features and user stories, what percentage of the
> requirements need to be formally documented before staffing for the
> construction phase?

The issue is not "in iterative development process". An overwhelming amount
of research of _all_ software development has shown that a large formal
requirements gathering effort correlates with a very high failure rate.

The highly iterative development processes require a simple solution:
Minimize the time between making a decision about specifications, and
collecting real feedback on the results of those decisions.

> Does 80% sound too much for you?

Yes. Do a "spike solution", which is a minimal implementation of the most
important features. Review the result for these criteria:

1) The vision and highest-priority 5% of requirements are stable
2) The architecture, in code, is stable
3) The approach to be used during testing is proven
4) Demonstrate that the technical risks have been deferred or handled

After collecting these data on project topology, add staff, and start adding
more features. The pipeline between making decisions about features and
reviewing results should be one week. That means every possible way to
automate the review should be investigated, including literate acceptance
test frameworks, and automated deployment tools.

> I know there is no magic answer, I just
> want to hear your experience is.

My experience using the miraculous process known as Code-and-Fix, for small
projects, consisted of writing a GUI, getting it reviewed, pushing back into
the features, getting them review, and making sure I never let the "easy
bug" count get too high. So, in retrospect, I was doing things half-right!

> BTW: I also posted my original question to the RUP forum and I got a few
> answers. Follow this link, if your are interested:
>
http://www-128.ibm.com/developerworks/forums/dw_expandTree.jsp?thread=64051&forum=335&cat=24&message=4730759#4730759

They still allow a longer pipeline between decision making and feedback.

(BTW this is a question for news:comp.software-eng ; it's only indirectly
about OO.)

-- 
  Phlip
  http://industrialxp.org/community/bin/view/Main/TestFirstUserInterfaces


Relevant Pages

  • Re: Marine GPS Reviews
    ... A handheld GPS? ... Do a careful comparison of what you want against the features on the ... I will thoroughly review the link you provided. ...
    (sci.geo.satellite-nav)
  • Re: New filesystem for Linux kernel
    ... I have to admit aufs is big, but actually, as I wrote in the documents, ... aufs2 has already dropped several features. ... If they have been reviewed, I'd ask you to review aufs2 too. ...
    (Linux-Kernel)
  • Re: Software Comparison Article
    ... By reviewing Goban you enter the territory of a lot of free programs/server clients, programs like glGo, CGoban, CGoban 2, qGo, Drago etc. ... I want to review stuff that runs on the current Mac and Windows OS. ... You said you only want to review commercial software with many features for now, I can understand that if I look at the free programs I have to use to get all the features I want;) That is: GoGrinder for problems, Kombilo for pattern search, gobase.org for pattern search, qGo for editing, glGo for IGS, CGoban 2 for KGS and uligo for testing if I remembered a pro game well. ...
    (rec.games.go)
  • Re: Software Comparison Article
    ... By reviewing Goban ... I want to review stuff that runs on the current Mac and Windows OS. ... You said you only want to review commercial software with many features ... Kombilo for pattern search, gobase.org for pattern search, qGo for ...
    (rec.games.go)

Loading