Hi Frank, We are using DWR in our project for Ajax. It is great framework and very easy to start with. The only problem is that it has very poor documentation. Whatever documentation we have at DWR Site is not sufficient. If we get stuck somewhere it takes so much time to fix it.
As of now I am facing a problem that when I make Ajax call for some weird reasons the Hibernate session is closed. It works in other places but this one is cribbing for the reason I don't know. The GetAhead document just mention the use of OpensessioninViewFilter, nothing else. The link they provide is also broken. This is the main problem with DWR.
Frank, my question to you is-Reading a book is great way to know a technology. But in the real implementation we need some solid documentation. Do you think in future the DWR documentation is going to improve? [ March 11, 2008: Message edited by: Bear Bibeault ]
That's ironic, I always thought the DWR documentation wasn't too bad I've definitely seen worse!
That being said, there's definitely deficiencies. I've always found the documentation of reverse AJAX to be lacking. While writing my book that was the one area I had a lot of trouble getting my head around because it wasn't explained very well, and worse still, there wasn't much in the way of decent examples (hopefully my book remedies that!)
As for when the docs will improve, that's clearly a question for Joe Walker and the DWR team. Of course, if you've ever dealt with an open-source project before you probably anticipated the standard answer to this sort of thing: go contribute yourself! I know for sure Joe and Co. will very happily accept any enhanced (and presumably correct!) documentation that comes their way.
I should also point out that the folks on the DWR mailing list are quite helpful, so even where the documentation may be lacking, I'd be surprised if you had trouble getting the answers you need on the mailing list.
(That's also a standard open-source answer - LOL)