Email: Password: Remember Me | Create Account (Free)

Back to Subject List

Old thread has been locked -- no new posts accepted in this thread
Ian Bell
03/11/06 07:13
Read: 505 times
United Kingdom

#111967 - Design Info
Responding to: Jan Waclawek's previous message
Jan Waclawek said:
So far I never managed to get more than about 10% of what is really needed before I presented version 0.1 to the client/boss/whoever. I guess if I'd be able to write down a specification and strictly obey it, anybody else could do my job as well.

I think you are in pretty much the same situation as everyone else. You just need to think about what you need to work as an ordered development and the documentation needs will become apparent. This was nearly always the case when I was a consultant because the clients are generally non-technical marketing folk who really don't know what they want. You have to lead them by the hand.

We always used to start with a Product Specification that described what the product was supposed to do and how well it should do it i.e. function and performance. It does not matter that this is incomplete but it does matter that all sections are present (even those not yet defined) as it serves to show the client what you need to know to complete the job. Then we did what we called a Feasibility Study but its purpose was basically to work out how we would do the design and to flesh out the Product Specification. We would often put crude software together as part of this to show the client (much like your version 0.1). Only once this was done did detailed design begin and by then most things were pretty much tied down.


List of 24 messages in thread
How do you manage Documentation?      Vignesh Prasad      03/10/06 06:04      
   As soon as you finish??      Andy Neil      03/10/06 07:13      
      User Manual      Vignesh Prasad      03/10/06 10:48      
         it all is very simple      Erik Malund      03/10/06 10:56      
   too late and totally wrong      Erik Malund      03/10/06 07:36      
      you have an easy life won't you      Jan Waclawek      03/10/06 08:40      
         Of course, you only have enough informat      Erik Malund      03/10/06 09:12      
            more on the above, the beauty of the hoo      Erik Malund      03/13/06 06:51      
               in C?      Jan Waclawek      03/13/06 07:51      
                  please do not accuse me of unnatural act      Erik Malund      03/13/06 08:02      
         Design Info      Ian Bell      03/11/06 07:13      
            viewpoint      Jan Waclawek      03/12/06 13:09      
               General Principles      Ian Bell      03/12/06 13:38      
                  the clients...      Jan Waclawek      03/12/06 14:00      
                     Client Variety      Ian Bell      03/14/06 05:26      
                     It's like I said last month ...      Richard Erlacher      04/02/06 18:25      
                  Great      Vignesh Prasad      04/01/06 00:31      
                     I, J OK      Ian Bell      04/02/06 15:10      
                        Repetition      Vignesh Prasad      04/03/06 10:40      
                           My old DOS based suite...      David Smith      04/03/06 11:17      
               Two categories      Oliver Sedlacek      04/03/06 02:34      
                  MIL498      Mahmood Elnasser      04/03/06 13:35      
   write the documentation first      Richard Erlacher      03/11/06 11:50      
      Good points..      Vignesh Prasad      03/12/06 10:05      

Back to Subject List