|
From: Janek B. <ya...@st...> - 2003-12-11 10:55:15
|
On Thu, 2003-12-11 at 05:40, j=C3=BCrgen h=C3=B6ller [werk3AT] wrote: > Darren, > =20 > I'm not sure if the samples add any complexity, but I think you're right = about the test tree. So I suggest to refine the "light edition" from my las= t mail to a 7.1 MB one with pre-built binaries, docs, framework sources, sa= mple sources, but without tests and just the minimum set of third-party lib= raries. > =20 > I think that it's very helpful to include framework sources in your IDE, = to get better argument naming when overriding methods, quick navigation to = sources of framework base classes, etc. I do that all the time with the JDK= and Hibernate; so do my werk3AT colleagues. And after all, Sun is shipping= the JDK with sources included - you just need to download the docs separat= ely there. Hibernate and Log4J ship with out-of-the-box sources too. > =20 > Furthermore, I believe that the samples are important particularly for "j= ust want to use it" people. After all, polished examples are a good compani= on to proper framework documentation, easing the entry into the framework r= ather than making it more complex, IMO. > =20 > Juergen > =20 As a new user of the framework I am finding it very useful to have the sources available within the IDE. It is often easier to search the=20 sources to establish facts about the framework than to use the external documentation. On the size issue, as a 28.8k modem user (at one location) the size of downloads (JBoss, JDKs) is an issue I normally solve by burning CD-Rs or using USB drives at another location. So an few extra megabytes won't affect me and shouldn't really be a consideration as I would guess other users in a similar situation use a similar tactic with large downloads.=20 -Janek |