OH, @#$%^&*!! I am myopic sometimes. Read along, friends; this gets fun.
First, thanks to all for comments on this thread. Now, here's some thought
resulting from thorough mastication of the available input (careful, Hal, I can
hear your snide response forming now...) ;>
Back to basics:
Q: What is the purpose of the Attributes section?
A: To communicate to the coder the variables about which s/he must be aware in
order to write the fuse.
Q: What is the purpose of the Responsibilities section?
A: To describe to the coder, in plain language, the processing required in the
fuse.
It seems to me that we have begun to muddy the border between these two very
different sections. This is to be avoided.
So what's to be done with ideas such as Erik's symbolic logic notation? Why,
it already has a place in the Fusedoc definition: optional sections.
I, for example, use a section called History to document maintenance changes
after the code goes into production.
Erik could define a section called, say, "Relationships" to describe, in
whatever form he chooses, the required relationships between the variables
introduced in the Attributes section. If his notation makes cool tools
possible, I (and other automation freaks like me) might adopt it, and refer to
Erik's documentation of his symbology.
So, we gain new capabilities without breaking the old, and all works.
See, Hal, your culpa wasn't so maxima after all. You built in a solution to
handle such unforeseen complications. Fusedoc works because it is elegant and
beautiful, not all-inclusive.
Chalk another one up for beauty...
- Jeff
==============================================================
| Jeffrey S. Peters | "Specialization is for insects." |
| [EMAIL PROTECTED] | - Lazarus Long |
| PGP key for Jeffrey S. Peters at ldap://keyserver.pgp.com |
==============================================================
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Structure your ColdFusion code with Fusebox. Get the official book at
http://www.fusionauthority.com/bkinfo.cfm
Archives: http://www.mail-archive.com/[email protected]/
Unsubscribe: http://www.houseoffusion.com/index.cfm?sidebar=lists
