Comment by goberle...@gmail.com:

I've been a long time Spring devotee, but I've moved to a group that doesn't (yet) grasp the benefits of IoC. I've long believed that Spring can be tedious and verbose, and I was wondering whether this might be an easier sell to those who are new to the concept.

But - while studying the examples, I tried to hop over to the JavaDoc to see what, exactly, the bind method did. First, you have some weird JavaDoc generator that doesn't list the classes in the bottom left frame, it seems, so the reader had better know which package to look in to find something. Second, after discovering the class (it's fully qualified name is com.google.inject.AbstractModule), I found that there is essentially no useful documentation.

Compared to Spring, which has extensive JavaDoc at the class and method levels, along with a wonderful reference manual, this seems immature and ad hoc. A well designed system is usually documented _first_. Introductory lessons and such are good to get started, but once you know the basics, you need either quality, hard-core internals reference docs, or you have to study the source code. I'll reserve judgment, lest someone point me in the direction of more comprehensive material. But I much dislike products where the knowledge is all folklore.

For more information:
http://code.google.com/p/google-guice/wiki/Motivation

--
You received this message because you are subscribed to the Google Groups 
"google-guice-dev" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to google-guice-dev+unsubscr...@googlegroups.com.
To post to this group, send email to google-guice-dev@googlegroups.com.
Visit this group at http://groups.google.com/group/google-guice-dev?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.


Reply via email to