RE: Is anyone fusedocing fusedocs?

[Gary]

I hang my had down in shame.   My only excuse is, FB code is so easy to read and understand.   -----Original Message----- From: Lee Borkman [mailto:[EMAIL PROTECTED]] Sent: 11 May 2002 00:48 To: [EMAIL PROTECTED] Subject: Re: Is anyone fusedocing fusedocs?   Hi John.   Fusedocs have several purposes.  Only one of these is to "document" the code.  Purposes include: �         specifying the code in the first place �         verifying the code against the spec �         seperating the roles of expert architect and expert coder �         automated documentation �         portability / language-independence �         consistency / predictability �         clarity �         automated generation �         automated testing Whatcha reckon?   LeeBB ----- Original Message ----- From: John Jonathan Kopanas   If comments are 1:1 isn't it better to just read the code?  Especially CF that is so easy to read.  I understand documenting what is not obvious in the code, but sometimes it gets to far. ----- Original Message ----- From: "Lee Borkman" <[EMAIL PROTECTED]> I don't know.  It's not uncommon to have 20 lines of Fusedoc and one line of code.  I'd worry if many or most of your fuses were like that, but it's perfectly reasonable now and then.  In general, I'd expect an average ratio of 1:1, but that's just a guess. LeeBB ----- Original Message -----   From: John Jonathan Kopanas   I hope you are being sarcastic.  Otherwise there is something wrong with   your code.   > Is anyone fusedocing fusedocs?  Im not sure that I   > will be satisfied with my applications unless my   > comments exceed my code by a ratio of at least 3:1. ==^================================================================ This email was sent to: [EMAIL PROTECTED]   EASY UNSUBSCRIBE click here: http://topica.com/u/?bUrFMa.bVK21L Or send an email to: [EMAIL PROTECTED]   T O P I C A -- Register now to manage your mail! http://www.topica.com/partner/tag02/register ==^================================================================ ==^================================================================ This email was sent to: archive@jab.org EASY UNSUBSCRIBE click here: http://topica.com/u/?bUrFMa.bV0Kx9 Or send an email to: [EMAIL PROTECTED] T O P I C A -- Register now to manage your mail! http://www.topica.com/partner/tag02/register ==^================================================================