One of the core technologies used in many web sites is some kind of form handling. It’s one of the the basic ways users interact with the site. My travails so far have led me to bump into no less than four packages for Catalyst.
Those would be:
- and something called Reaction.
The thought just crossed my mind to check the Catalyst Wiki and (lo! and behold!) there’s a page with pretty much the same list. There was also something about Rose::HTML::Objects, but I’ve not looked at that yet and can’t comment.
Reaction seemed like a bit of overkill for my current project, and the documentation was *ahem* a little sparse, so that left me to choose from the first three listed.
I have been reliably informed that FormBuilder is officially passé and no one in their right mind would even consider using it. My counter-argument that the samples and tutorials were all using FormBuilder now seems to be moot as someone has changed the tutorial to use FormFu. I see the name Kennedy Clark on that page, so doubleplusgood there, sir. 🙂
I moved on to FormFu and was told I shouldn’t bother because it was in the process of being superseded by FormHandler. I’m always wary of being on the bleeding edge, especially with OpenSource projects. The FormFu docs made my head hurt marginally less, so I’m moving ahead with FormFu.
The FormFu reference documentation seems to cover the bases (which isn’t always true in open source projects), but there seem to be a number of serious gaps. For example, all the samples are in YAML, so if you don’t grok YAML–well, no samples for you… This happens a lot in open source projects where the samples, examples, etc. are all written by a small group with a shared mind-set. So far it’s only slowed forward progress, but it’s still sub-optimal.
Another example–and this is endemic to open source projects–is a lack of practical, “how do I do the obvious” type of documentation. Yeah, I know… it’s obvious so why does it need to be documented?
First, any two people making a list of things that are “obvious” and things that need further explanation will frequently create very different lists. Second, making the list itself requires serious introspection. It is easy to miss things that are completely invisible either to outsiders with limited knowledge or to insiders with “too much” knowledge.
This brings me to my current conundrum. I’m at a unique moment here–I don’t know too much, so a lot of what’s missing in the documentation is still fresh or soon-to-be-discovered. I’m making notes about the problems I’m encountering, where things are hidden, and making cheat-sheets about what the other folks I’m working with will need to know so they can come up to speed. That’s exactly the kind of thing that should go in the documentation, right? So…
- Is FormFu on the cusp of being superseded? Would it be a waste of time to try to contribute to the documentation of a project about to become passé, like FormBuilder before it?
- Are the FormFu folks receptive to documentation contributions? That would include answering questions and actually including new or updated docs.
(Hey! Look! A Poll over there in the sidebar!)
My limited dealings with the open source “community” hasn’t completely crushed my belief there must be reasonable, adult, professionals out there but the use of “source is available” or “RTFM” as some sort of be all, end all of knowledge transfer leaves me cold, both as a coder and as a writer.
Hm. It’s late and I feel a rant coming on so I’ll stop here.
More as it happens.
I know this can cause a lot of confusion, form handling and user interface generation is something that the the Catalyst community has been grappling with for a long time. So far we get things that work but at some point are not flexible enough to justify using over just plain old html forms hand coded.
There’s a constellation of problems we are trying to solve, everything from html generation to database bindings, clear expression of user interface logic etc. Usually a form generation tool (I’m currently using FormHandler, for what that’s worth) starts off feeling like crack, suddenly you get a lot done UNTIL you have a need with a tiny bit of a twist and then suddenly you feel like the tools are not exactly right, that the form generator is conflating itself with the template tool, etc. I think we are still going to be working on this for a while.
You may wish to add Form::Sensible to your list. This has more Reaction inspired stuff (from what I’ve been told) in it but much more focused and simple. Is a new project though and you expressed reservations
I look forward to seeing how things turn out for you.
I think there’s space for more than 1 Catalyst / form module – different people think in different ways, or just want to do things differently.
FormFu’s still supported and being developed, so your contributions would definitely be welcomed. If you have (or create) a google account, send me your email address, and I’ve give you commit access.
Hey! No fair! It’s so much easier for me to just complain! 😀
I guess this answers the “are they receptive to documentation contributions” question, doesn’t it?
Well, this puts the ball firmly in my court! The peanut gallery here is not-very-subtly encouraging me to do so, too. Let me
ignorethink about this a couple of days, get one of those Google things, and figure out how this whole commit thing is supposed to work.
Smart-assery aside, thanks for the invitation. I will seriously consider it.
Has anyone heard any news about the future of Reaction?
Not I, but I’m not really following it.
Have you tried their project forum? Yeah, there’s nothing there right now, but looks like lots of folks monitoring it.
In the Support section of the project docs, there is a mention of #reaction on irc.perl.org. Might be someone up there that might know.
You could also try poking Matt Trout directly.
I guess that formbuilder is not so obsolete. Formfu and FormHandler are both gone from CPAN.
FormHander (on CPAN) looks current. Last update 2012-Oct-15.
FormFu (on CPAN) is marked Deprecated, but refers to Catalyst::Controller::HTML::FormFu instead. Last update: 2012-Sep-18
Even Catalyst::Plugin::FormBuilder has been deprecated in favor of Catalyst::Controller::FormBuilder. Last updated 2011-Jan-26.
At first glance (second glance, in this case, I suppose 🙂 ) it looks like all of them are plausibly active. I kinda’ see that as a good thing, really.