Nah, I'll tell ya why I think so... The thing I like about FuseDoc is its
simple enough where I can manually type in the fusedoc for a template with
very little work. I've got a generic FuseDoc snippet stored in CF Studio,
and I then fill in the blanks. FuseDoc as text is easily human readable.
XML, WDDX, or other tagging schemes tend to have too much metadata in
relation to the data. Too darn hard to read in Notepad or some other
plain-text output.
Its a balancing act between functionality and simplicity. But hey, doesn't
every app we develop come under that principle?
Alan McCollough
Web Programmer
Allaire Certified ColdFusion Developer
Alaska Native Medical Center
> -----Original Message-----
> From: John Foulds [SMTP:[EMAIL PROTECTED]]
> Sent: Friday, August 25, 2000 8:15 AM
> To: [EMAIL PROTECTED]
> Subject: Re: Documentation System for Cold Fusion
>
> Perhaps FuseDoc should just be XML, with an external DTD residing
> somewhere
> common.
>
> But it's not the lingo of the schema that matters, just making sure that
> an
> engine can read from it, and then parse the documentation in an
> application's templates and drop the results into a DB where it can be
> utilized by other documentation programs. ie:
>
> *a parent/child template browser
> *a todo list (add FuseDoc element "Outstanding Items")
> *a template description manual
> *a query or variable dependency browser
> *a change management viewer
> *an author work history
> *etc.
>
> p.s. packet? So Allarian.
>
> John Foulds
> Ottawa, Canada
>
>
>
> ----- Original Message -----
> From: "Hal Helms" <[EMAIL PROTECTED]>
> To: <[EMAIL PROTECTED]>
> Sent: Thursday, August 24, 2000 2:29 PM
> Subject: RE: Documentation System for Cold Fusion
>
>
> > John,
> >
> > I've been talking some with Lee about this and my thought is that
> ideally
> > Fusedoc should have a way of declaring a template that an engine could
> use
> > to decode it. This would mean that we wouldn't be defining the precise
> > structure of Fusedoc but a Fusedoc meta-structure. An analogy might be
> XML
> > where the DTD defines the structure of a valid XML packet. This probably
> > sounds a bit weird, but the possibilities are very rich if we adopt
> this.
> > Obviously, a good deal of work has to be done.
> >
> > -----Original Message-----
> > From: John Quarto-vonTivadar [mailto:[EMAIL PROTECTED]]
> > Sent: Wednesday, August 23, 2000 8:56 PM
> > To: [EMAIL PROTECTED]
> > Subject: Re: Documentation System for Cold Fusion
> >
> >
> > Hal,
> >
> > do you subscribe to the modified form of Fusedox that Lee seems to be
> using?
> > Either way works but in order to move the tool forward some of the
> Fusedoc
> > should stabilize. I just realized how usefull Lee's tool could be with
> some
> > expansions, yet I also have 8-10 complete sites already done in the
> "old"
> > (??) Fusedoc style (remember START FUSEDOC and END FUSEDOC )?
> >
> >
> > > Absolutely, Lee. I'll get it up there within the next day or so. I
> think
> > > what Lee did is excellent and I hope we can continue to evolve Fusedoc
> to
> > > where it does a good job of meeting everyone's needs.
> >
> >
> >
> --------------------------------------------------------------------------
> --
> > --
> > 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.
