hand).
As for Fusebox; books are fine - if you're that inclined or really need to
learn it. But for those with casual interest they need something right up
front that explains why they should want to use it. Another reason is that
the framework is free: so why should I have to buy a book to get basic
information?
These tools/frameworks are trying to convince people to use them: just basic
marketing states that the process should be as absolutely painless as
possible.
Also, and this is of course, personal opinion: many of the books for
technical topics (especially niche ones) are awful. Again, its people that
are really good at writing code trying to write books (I shudder when I
think about some of the early FuseBox documentation by Steve Nelson - who
was a genius programmer). At the very least many of the smaller books just
plain lack competent editing or design.
Jim Davis
_____
From: Michael T. Tangorre [mailto:[EMAIL PROTECTED]
Sent: Thursday, December 11, 2003 6:50 PM
To: CF-Talk
Subject: RE: fusebox
I think that books along with a free saturday morning is documentation
enough.... what is everyone exactly looking for?!
_____
From: Jim Davis [mailto:[EMAIL PROTECTED]
Sent: Thursday, December 11, 2003 6:26 PM
To: CF-Talk
Subject: RE: fusebox
That's been a problem for a lot of frameworks - and for FuseBox since the
beginning: incredibly smart guys building incredibly cool tools who have a
complete, innate inability to explain anything to anyone. ;^)
Jim Davis
_____
From: S. Isaac Dealey [mailto:[EMAIL PROTECTED]
Sent: Thursday, December 11, 2003 5:44 PM
To: CF-Talk
Subject: RE: fusebox
> Hi,
> I suppose the lack of documentation does tend to put
> people off a bit, but I
> don't fuss too much about buying the books. They are worth
> the small price
> and the guys that bring us Fusebox can't do everything for
> free... people
> have to eat ya know. I seem to remember everyone
> recommending CFWACK as
> "the" resource back in the day. :) The Techspedition books
> are pretty much
> the same caliber of resource for Fusebox.
Incidentaly, I hope my comments aren't seen as a disrespect to the
guys who bring us the Fusebox framework. We all have areas where our
work is either beautiful or in some way incomplete or problematic. I
just feel like the documentation from fusebox.org at this point is a
real weakness and that someone (who is really immaterial) should take
the time to sit down and produce some basic "step 1) this is how to
write an fbx_circuits.cfm" (or take it from another site that has a
free tutorial) that will go in their core files download. I understand
the info is likely available elsewhere for free also, i.e.
techspedition, the forums, etc. but some basic info I think really
needs to be "up-front" and right now that's missing from the core
files. I haven't looked at FB4 yet, so I can't comment on documenation
for the new version.
Of course I always welcome criticism of my own documentation as well
-- if you read through my blog, there've been several cases of my
documentation for the onTap framework needing correction for one
reason or another and I always try to get those cleared up ASAP when I
find them or when someone points them out.
s. isaac dealey 214-823-9345
team macromedia volunteer http://www.macromedia.com/go/team
chief architect, tapestry cms http://products.turnkey.to
onTap is open source http://www.turnkey.to/ontap
_____
_____
_____
[Todays Threads] [This Message] [Subscription] [Fast Unsubscribe] [User Settings]

