Re: To hell with the program spec - I know what's best

From	David Brown <david.brown@hesbynett.no>
Newsgroups	comp.programming
Subject	Re: To hell with the program spec - I know what's best
Date	2016-07-26 15:41 +0200
Organization	A noiseless patient Spider
Message-ID	<nn7pao$be7$1@dont-email.me> (permalink)
References	<nn6vmo$lh0$1@dont-email.me>

Show all headers | View raw

On 26/07/16 08:24, Richard Heathfield wrote:
> In a recent discussion, the idea of working to a program specification
> came up. It was ridiculed in one quarter, and defended in others.
> 
> 
> The trouble with not sticking to the spec is that you don't meet the
> clients' expectations, and it's the client that pays the bills. If you
> don't do what is asked, the client may well be in a position to refuse
> to pay for the work. The same applies to anything you did do that was
> /not/ asked for.
> 

The trick is to persuade the customer that they are not qualified to
write the specification (very few customers /are/ qualified to write a
spec properly).  So you offer to do that too.

This way the customer writes a "requirements specification" with loser
terms, such as "Write a program that displays a simple message".

/You/ then write the software specification, "Write a simple C program
that displays Hello, World!".  The customer signs off on the software
specification, and you get paid for writing that.

Then you write the code.  Since you wrote the spec, you presumably wrote
it knowing you have a reasonable chance of actually writing matching
code.  But suppose you didn't - perhaps your code prints out "C
Programming".  Then you change your software specification to match,
release that as specification document 1.01, and get paid for
maintenance of the specification document as well as for writing the
program.  It all still matches the customer's actual requirements, and
the software specification and the code are synchronised.  Everyone is
happy :-)

More generally, there is a continuous progression from "I want a program
to solve my problem" down to the actual final code.  There are no fixed
points to say "this is the requirements", "this is the design
specification", "this is the code specification", "this is the
functional model", "this is the prototype code", etc.  The key to doing
the work successfully is to get the right level of detail at the right
place, choosing carefully where you keep things open and where you flesh
out all the details, and being sure of which parts are open to change
and who can change them.

Thread

To hell with the program spec - I know what's best Richard Heathfield <rjh@cpax.org.uk> - 2016-07-26 07:24 +0100
  Re: To hell with the program spec - I know what's best Richard Heathfield <rjh@cpax.org.uk> - 2016-07-26 13:42 +0100
    Re: To hell with the program spec - I know what's best Ike Naar <ike@iceland.freeshell.org> - 2016-07-26 13:23 +0000
      Re: To hell with the program spec - I know what's best Richard Heathfield <rjh@cpax.org.uk> - 2016-07-26 14:51 +0100
        Re: To hell with the program spec - I know what's best "J. Clarke" <j.clarke.873638@gmail.com> - 2016-07-26 22:29 -0400
    Re: To hell with the program spec - I know what's best David Brown <david.brown@hesbynett.no> - 2016-07-26 16:53 +0200
  Re: To hell with the program spec - I know what's best Julio Di Egidio <julio@diegidio.name> - 2016-07-26 06:29 -0700
  Re: To hell with the program spec - I know what's best David Brown <david.brown@hesbynett.no> - 2016-07-26 15:41 +0200
    Re: To hell with the program spec - I know what's best Julio Di Egidio <julio@diegidio.name> - 2016-07-26 10:08 -0700
  Re: To hell with the program spec - I know what's best "Ant" <not@home.today> - 2016-07-26 19:50 +0100
    Re: To hell with the program spec - I know what's best "Osmium" <r124c4u102@comcast.net> - 2016-07-26 14:32 -0500
  Re: To hell with the program spec - I know what's best "J. Clarke" <j.clarke.873638@gmail.com> - 2016-07-26 22:26 -0400
    Re: To hell with the program spec - I know what's best Kaz Kylheku <349-534-5780@kylheku.com> - 2016-07-27 03:57 +0000
      Re: To hell with the program spec - I know what's best Richard Heathfield <rjh@cpax.org.uk> - 2016-07-27 08:21 +0100
        Re: To hell with the program spec - I know what's best "J. Clarke" <j.clarke.873638@gmail.com> - 2016-07-28 06:43 -0400
          Re: To hell with the program spec - I know what's best Richard Heathfield <rjh@cpax.org.uk> - 2016-07-28 12:12 +0100
      Re: To hell with the program spec - I know what's best "J. Clarke" <j.clarke.873638@gmail.com> - 2016-07-28 06:40 -0400
    Re: To hell with the program spec - I know what's best Richard Heathfield <rjh@cpax.org.uk> - 2016-07-27 08:10 +0100
      Re: To hell with the program spec - I know what's best BartC <bc@freeuk.com> - 2016-07-27 11:04 +0100
        Re: To hell with the program spec - I know what's best Richard Heathfield <rjh@cpax.org.uk> - 2016-07-27 14:05 +0100
          Re: To hell with the program spec - I know what's best BartC <bc@freeuk.com> - 2016-07-27 18:21 +0100
            Re: To hell with the program spec - I know what's best Richard Heathfield <rjh@cpax.org.uk> - 2016-07-27 18:56 +0100
          Re: To hell with the program spec - I know what's best "J. Clarke" <j.clarke.873638@gmail.com> - 2016-07-28 06:51 -0400
            Re: To hell with the program spec - I know what's best Richard Heathfield <rjh@cpax.org.uk> - 2016-07-28 12:26 +0100
        Re: To hell with the program spec - I know what's best Wally W. <ww84wa@aim.com> - 2016-07-27 19:51 -0400
          Re: To hell with the program spec - I know what's best "Osmium" <r124c4u102@comcast.net> - 2016-07-27 22:37 -0500
            Re: To hell with the program spec - I know what's best Richard Heathfield <rjh@cpax.org.uk> - 2016-07-28 07:28 +0100
              Re: To hell with the program spec - I know what's best "J. Clarke" <j.clarke.873638@gmail.com> - 2016-07-28 06:54 -0400
            Re: To hell with the program spec - I know what's best "J. Clarke" <j.clarke.873638@gmail.com> - 2016-07-28 06:53 -0400
              Re: To hell with the program spec - I know what's best Wally W. <ww84wa@aim.com> - 2016-07-28 08:38 -0400
      Re: To hell with the program spec - I know what's best Öö Tiib <ootiib@hot.ee> - 2016-07-27 05:52 -0700
      Re: To hell with the program spec - I know what's best "J. Clarke" <j.clarke.873638@gmail.com> - 2016-07-28 06:48 -0400
        Re: To hell with the program spec - I know what's best Richard Heathfield <rjh@cpax.org.uk> - 2016-07-28 12:21 +0100
          Re: To hell with the program spec - I know what's best Wally W. <ww84wa@aim.com> - 2016-07-28 08:47 -0400
            Re: To hell with the program spec - I know what's best Randy Howard <rhoward.mx@EverybodyUsesIt.com> - 2016-07-28 16:13 -0500
              Re: To hell with the program spec - I know what's best Richard Heathfield <rjh@cpax.org.uk> - 2016-07-28 22:38 +0100

csiph-web