Length really depends on the audience and the application. Once you've done a few release cycles with your dev team, you learn the optimal size for your specs as well as the fidelity required for them.
This is particularly true when you are working on a product with existing features, workflow and conventions, etc. Being thorough is key but so is being as concise as possible - this minimizes superfluous information and reduces the time required to generate the documentation in the first place. Of course, YMMV according to your needs, team and particular process. On 3/11/08, Sebi Tauciuc <[EMAIL PROTECTED]> wrote: > > On Tue, Mar 11, 2008 at 12:02 PM, vlad <[EMAIL PROTECTED]> wrote: > > > Hi everyone. > > > > Angel said: " # 3: Be concise! Nobody wants to read a 500 page spec no > > matter how > > pretty it is. ;-) " > > > > Now I have to reply to this. To "be as specific as possible" means to > give > > as much detail as one would need to perfectly and thouroughly understand > > the > > problem at hand. Isn't this rule in contradiction with your #3? :-P > > > > > > Not necessarily, I would say. You can give all the needed details in a > concise or a less concise way. Did you really need 500pages to give all > the > *needed* details or would 50 have been enough? I guess it's about how > efficient your communication is, given you know what needs to be > communicated. > > > -- > Sergiu Sebastian Tauciuc > http://www.sergiutauciuc.ro/en/ > > ________________________________________________________________ > Welcome to the Interaction Design Association (IxDA)! > To post to this list ....... [EMAIL PROTECTED] > Unsubscribe ................ http://www.ixda.org/unsubscribe > List Guidelines ............ http://www.ixda.org/guidelines > List Help .................. http://www.ixda.org/help > -- -------------------------------------------------- www.flyingyogi.com -------------------------------------------------- ________________________________________________________________ Welcome to the Interaction Design Association (IxDA)! To post to this list ....... [EMAIL PROTECTED] Unsubscribe ................ http://www.ixda.org/unsubscribe List Guidelines ............ http://www.ixda.org/guidelines List Help .................. http://www.ixda.org/help
