RE: Documentation examples

2003-03-19 Thread Ryan Emerle
Enumeration Suite can be found here: http://www.emerle.net/programming/index.cfm Hope it helps someone :) -- Ryan Emerle -Original Message- From: Everett, Al [mailto:[EMAIL PROTECTED] Sent: Tuesday, March 18, 2003 11:13 AM To: CF-Talk Subject: RE: Documentation examples There is a version

Documentation examples

2003-03-18 Thread Everett, Al
Documentation is the worst part of development. Does anybody have any documentation for CFCs/CustomTags/Modules/Functions ? Specifically a document which shows attributes/parameters, output values, etc. I could probably roll my own but if there's a widely accepted standard I'd like to use that.

RE: Documentation examples

2003-03-18 Thread webguy
CFC should be self-documenting Look at cflib.org for the the doc stuff for udfs (inder tools I think) You can use the same format for tags and pages too. WG -Original Message- From: Everett, Al [mailto:[EMAIL PROTECTED] Sent: 18 March 2003 13:25 To: CF-Talk Subject: Documentation

RE: Documentation examples

2003-03-18 Thread Everett, Al
CFC should be self-documenting Sure, AFTER it's been written. I need stuff for before anything is written. (Can you believe they actually expect me to plan things out?!) Look at cflib.org for the the doc stuff for udfs (inder tools I think) You can use the same format for tags and pages too.

Re: Documentation examples

2003-03-18 Thread jochemd
Quoting Everett, Al [EMAIL PROTECTED]: Documentation is the worst part of development. Does anybody have any documentation for CFCs/CustomTags/Modules/Functions ? Specifically a document which shows attributes/parameters, output values, etc. I could probably roll my own but if there's a

Re: Documentation examples

2003-03-18 Thread Nick de Voil
Maybe you should take javadoc into consideration also. I wouldn't know of any such standard, but it is an issue I have encountered as well. What I was wondering is if there would be any interest in defining an XML schema for documentation and write some tools to create several derivative

RE: Documentation examples

2003-03-18 Thread webguy
of UML books, but you will probably only use sections of it with CF... WG -Original Message- From: Everett, Al [mailto:[EMAIL PROTECTED] Sent: 18 March 2003 13:34 To: CF-Talk Subject: RE: Documentation examples CFC should be self-documenting Sure, AFTER it's been written. I need stuff

Re: Documentation examples

2003-03-18 Thread Drew Harris
How about Fusedocs? Architecting information http://www.fusebox.org/index.cfm?fuseaction=methodology.Architecting A conversation about fusedocs: http://www.secretagents.com/index.cfm?fuseaction=free.conversation9 The standard as a DTD: http://fusebox.org/fd4.dtd -Drew Harris On 3/18/03 7:25

Re: Documentation examples

2003-03-18 Thread mark brinkworth
There are various XML documentation schemes that could be used as a starting point. Cheers Maybe you should take javadoc into consideration also. I wouldn't know of any such standard, but it is an issue I have encountered as well. What I was wondering is if there would be any interest

RE: Documentation examples

2003-03-18 Thread Raymond Camden
, 2003 7:43 AM To: CF-Talk Subject: Re: Documentation examples Maybe you should take javadoc into consideration also. I wouldn't know of any such standard, but it is an issue I have encountered as well. What I was wondering is if there would be any interest in defining an XML schema

RE: Documentation examples

2003-03-18 Thread Everett, Al
There is a version of JavaDoc for UDFs call UDFDoc. There is even a tool to generate docs from it. This can be downloaded from cflib.org. Has anybody done anything similar for regular CF templates? Obviously nothing can inspect what's going on in the template like you can with a function, but

RE: Documentation examples

2003-03-18 Thread Raymond Camden
:[EMAIL PROTECTED] Sent: Tuesday, March 18, 2003 10:13 AM To: CF-Talk Subject: RE: Documentation examples There is a version of JavaDoc for UDFs call UDFDoc. There is even a tool to generate docs from it. This can be downloaded from cflib.org. Has anybody done anything similar

RE: Documentation examples

2003-03-18 Thread Barney Boisvert
- From: Everett, Al [mailto:[EMAIL PROTECTED] Sent: Tuesday, March 18, 2003 8:13 AM To: CF-Talk Subject: RE: Documentation examples There is a version of JavaDoc for UDFs call UDFDoc. There is even a tool to generate docs from it. This can be downloaded from cflib.org. Has anybody done

RE: Documentation examples

2003-03-18 Thread webguy
the current project WG -Original Message- From: Everett, Al [mailto:[EMAIL PROTECTED] Sent: 18 March 2003 16:13 To: CF-Talk Subject: RE: Documentation examples There is a version of JavaDoc for UDFs call UDFDoc. There is even a tool to generate docs from it. This can be downloaded from

Re: Documentation examples

2003-03-18 Thread Drew Harris
You all should really check out Fusedocs and all the great tools that have been developed to use with them. -Drew Harris On 3/18/03 10:12 AM, Everett, Al [EMAIL PROTECTED] wrote: Has anybody done anything similar for regular CF templates? Obviously nothing can inspect what's going on in the