On 2/20/08, sebb <[EMAIL PROTECTED]> wrote:
> No major problems, however there are some items that can be improved:
>
>  Dependency Listings entry:
>
>  >>>
>  Commons Proxy
>
>  Java library for dynamic proxying
>
>  ../../../../../people.apache.org/www/commons.apache.org/proper/proxy/
>  <<<
>
>  Not sure where that originates, but it does not look right.
>
>  Ideally there should be a Developer or Building page describing how to
>  build the code.
>

By the way, there is a "Building Components" link on the navigation
pane on the left of every commons component site.  However, it doesn't
have m2 instructions.  Maybe it should.  Then I wouldn't have to
create a proxy-specific one.

>  It would be useful to have a text file in the source archive with
>  basic build info as well.
>
>  It would be good to mention the required Java version in the Release Notes.
>
>
>  On 20/02/2008, Emmanuel Bourg <[EMAIL PROTECTED]> wrote:
>  > A few suggestions for the next release (don't hold 1.0 just for this if
>  >  you don't have the time) :
>  >
>  >  - A tutorial with short code examples would be nice to get a quick taste
>  >  of the API. The overview page is not very sexy, I'm not a proxy guru and
>  >  I'm not sure to understand what I can achieve with the component.
>  >
>  >  - package.html files are missing, the consequence is an almost blank
>  >  table when the Javadoc is opened
>  >
>  >  - the javadoc for classes such as JavassistUtils is missing. Some
>  >  classes or interfaces with only one method have a javadoc at the class
>  >  level but not at the method level. I understand that the method comment
>  >  will most likely be redundant, but it's still useful for an IDE such as
>  >  IntelliJ that can display the method documentation in a popup window.
>  >
>  >
>  >  Emmanuel Bourg
>  >
>  >
>  >
>  >  ---------------------------------------------------------------------
>  >  To unsubscribe, e-mail: [EMAIL PROTECTED]
>  >  For additional commands, e-mail: [EMAIL PROTECTED]
>  >
>  >
>
>  ---------------------------------------------------------------------
>  To unsubscribe, e-mail: [EMAIL PROTECTED]
>  For additional commands, e-mail: [EMAIL PROTECTED]
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to