Viewing Individual Entry / Main
  ::   August 25, 2004

Summary of Third Party CFC Documentation Tools
My team has been doing a lot of work with the Mach-II framework lately, and we're extremely heavy users of CFCs. On top of this, we're busy making sure our SDLC complies with the requirements of the Sarbanes Oxley Act. One of the areas of special interest is documentation. The nice thing about CFCs is that they are [relatively] self documenting, provided you populate the various cfcomponent, cffunction, and cfproperty tag attributes. While ColdFusion MX comes with two tools for examining the CFCs on your system. The CFC Explorer can be invoked by entering the URL to any CFC accessible via a URL on your server. In our case, the majority of our CFCs are NOT accessible via URL as they are located in a directory outside of our web root. In this case, you can use the Component Browser that comes with ColdFusion MX. This tool can be accessed like this:

http://localhost/cfide/componentutils/componentdoc.cfm

Using this tool, however, requires that you use either the RDS or CF Admin password to access the browser. This may or may not be an issue depending on your local setup and policies. In any case, the auto generated documentation created by the CFC Explorer and the Component Browser is identical. It's a good start, but there are an increasing number of third party tools that take the basic concepts in these tools and extend them. I'm going to share the three that I'm aware of and have used in various capacities to auto-generate documentation on my CFCs. If you are aware of other tools, let me know!

CFCRemoteDocumenter (Nathan Dintenfass)

CFC Explorer With Usage (Marcantonio da Silva)

CFC Documentation Tool (Spike Milligan)

Component Invoker & Browser (Brandon Purcell)



Calendar
Sun Mon Tue Wed Thu Fri Sat
          1 2
3 4 5 6 7 8 9
10 11 12 13 14 15 16
17 18 19 20 21 22 23
24 25 26 27 28 29 30
31            

Recommended Reading
The Extraterritorial System In China: Final Phase (Harvard East Asian Monographs)

Archives by Subject
Announcements (28)
ColdFusion (61)
Database (12)
Dreamweaver (1)
Flash (2)
Flash Remoting (2)
Flex (3)
General Development (2)
Homesite + (1)
Mach-II (3)
MAX (9)
Mozilla (2)
Music (1)
Politics (1)
Portals (2)
Travel (2)

Search

Links
CFLib.org
Raymond Camden's Blog
Christian Cantrell's Blog
Sean Corfield's Blog
Nathan Dintenfass' Blog
Todd Rafferty's Blog
Steve Rittler's Blog
Cameron Childress's Blog

Credits
Based on blog.cfc by Raymond Camden

XML Feed