I'll toss in 4 cents here..
1. I'm totally guilty of "documenting after coding".
2. I wouldn't expect any automated app to analyze code and produce useful
documentation that would show the thought processess, the business logic,
the overall "idea" behind the whole thing.
3. Fusedoc works great as both a prior-to-coding, and
cover-yer-behind-after-the-fact documentation system; I'm not knocking other
systems, its just that I've latched onto this Fusedoc thing and am runnin'
with it.
4. I have a saying, it oughtta be on bumper stickers and coffee cups. "You
can't fight policy with technology". If developers don't document their work
(policy: document your code), no app (technology: bail me out!) is gonna do
the job. I also have another saying, "Gun Registration = Gun Confiscation",
but that's another bumper sticker...
Alan McCollough
Web Programmer
Allaire Certified ColdFusion Developer
Alaska Native Medical Center
> -----Original Message-----
> From: Brian P. Doyle [SMTP:[EMAIL PROTECTED]]
> Sent: Wednesday, August 23, 2000 7:23 AM
> To: [EMAIL PROTECTED]
> Subject: RE: Documentation System for Cold Fusion
>
> I too think it's pretty slick.
>
> I would however also LOVE a program that lets you quickly add
> documentation
> to every single page (not just read it off the page). I am guilty of
> being
> lazy sometimes when I want to crank some stuff out. Actually I thought
> thats what fusedoc was, a program that helped you quickly comment pages.
>
> -----Original Message-----
> From: Paul Johnston [mailto:[EMAIL PROTECTED]]
> Sent: Wednesday, August 23, 2000 11:06 AM
> To: Fusebox; Cf-Talk
> Subject: FW: Documentation System for Cold Fusion
>
>
> I have one happy programmer. Any more comments?
>
> Paul
>
> > -----Original Message-----
> > From: John Foulds [mailto:[EMAIL PROTECTED]]
> > Sent: 23 August 2000 15:52
> > To: Paul Johnston
> > Subject: Re: Documentation System for Cold Fusion
> >
> >
> > Oh Man! This freakin rocks!
> >
> > I am almost finished a big app that I have to deliver to a team of
> > programmers where I used to work, and this will make them REALLY, REALLY
> > happy. It's truly ingenious.
> >
> > I'm plugging it in as I type this.
> >
> > Thanks a mil,
> >
> > John
> >
> >
> > ----- Original Message -----
> > From: "Paul Johnston" <[EMAIL PROTECTED]>
> > To: "Fusebox" <[EMAIL PROTECTED]>; "Cf-Talk"
> > <[EMAIL PROTECTED]>
> > Sent: Wednesday, August 23, 2000 7:25 AM
> > Subject: Documentation System for Cold Fusion
> >
> >
> > > Due to the lack of interest in my last posting, I am re-posting
> > (sort of)
> > a
> > > mail to get some feedback.
> > >
> > > I have created a documentation system called cfdoc. I know there are
> > > others, but they all seem a little complex for me, and not so
> > transferrable
> > > and useful in other circumstances. It took me about an hour to
> > create it,
> > > and it now has a web page where you can download the browser
> > that I made,
> > > and there is also a syntax reference. It is similar to Plain Old
> > > Documentation (as in Perldoc) because it is similar in style,
> > simple, and
> > > straightforward to use.
> > >
> > > Please have a look, and download it. You can modify the code,
> > but please
> > > tell me before making any major changes.
> > >
> > > The web site is
> > >
> > > http://www.cfm-resources.com/members/cfdoc/
> > >
> > > Again, feedback would be really helpful.
> > >
> > > Thanks
> > >
> > > Paul
> > >
> > >
> > >
> >
> --------------------------------------------------------------------------
> > ----
> > > To Unsubscribe visit
> > http://www.houseoffusion.com/index.cfm?sidebar=lists&body=lists/fusebox
> or
> > send a message to [EMAIL PROTECTED] with 'unsubscribe'
> in
> > the body.
> >
> >
>
>
> --------------------------------------------------------------------------
> --
> --
> To Unsubscribe visit
> http://www.houseoffusion.com/index.cfm?sidebar=lists&body=lists/fusebox or
> send a message to [EMAIL PROTECTED] with 'unsubscribe' in
> the body.
>
>
> --------------------------------------------------------------------------
> ----
> To Unsubscribe visit
> http://www.houseoffusion.com/index.cfm?sidebar=lists&body=lists/fusebox or
> send a message to [EMAIL PROTECTED] with 'unsubscribe' in
> the body.
------------------------------------------------------------------------------
To Unsubscribe visit
http://www.houseoffusion.com/index.cfm?sidebar=lists&body=lists/fusebox or send a
message to [EMAIL PROTECTED] with 'unsubscribe' in the body.
