Comment by [email protected]:
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 [email protected].
To post to this group, send email to [email protected].
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.
