dev@grizzly.java.net

Re: Documentation efforts for Grizzly 2.0

From: Bongjae Chang <bongjae.chang_at_gmail.com>
Date: Tue, 15 Feb 2011 15:09:21 +0900

Hi Ryan,

I read the documentation simply and I found some typos.:-)

Here is my trivial review.
================
* http://grizzly.java.net/nonav/docs/docbkx/html/ch01.html
- HTP Server framework which offers high level abstractions to the HTTP
protocol (not unlike Servlets)
--> HTTP Server framework ...


* http://grizzly.java.net/nonav/docs/docbkx/html/ch01s04.html
- http://antwerks.com/
--> empty page

- http://blogs.sun/com/rlubke
--> http://blogs.sun.com/rlubke


* http://grizzly.java.net/nonav/docs/docbkx/html/ch02.html
- Grizzly 2.0 introduces a new subsystem to inprove memory mamangement
within the runtime. This subsystem is comprised of three main artifacts:
--> Grizzly 2.0 introduces a new subsystem to improve ...

- Figure2.1, Figure2.2 and Figure2.3 don't have images.


* http://grizzly.java.net/nonav/docs/docbkx/html/ch02s02.html
public interface IOStrategy {
    boolean executeIoEvent(Connection connection, IOEvent ioEvent)
    throws IOException;
}
-->
public interface IOStrategy extends WorkerThreadPoolConfigProducer {
    boolean executeIoEvent(final Connection connection, IOEvent ioEvent)
    throws IOException;
}


* http://grizzly.java.net/nonav/docs/docbkx/html/ch02s03.html
- I couldn't see diagram images on this page.


* http://grizzly.java.net/nonav/docs/docbkx/html/ch02s04.html
- I couldn't see images on this page.

- The event initiator may chose to emit the event upstream or downstream
by FilterChain like:
--> The event initiator may choose to ...


* http://grizzly.java.net/nonav/docs/docbkx/html/ch02s08.html
In Asynchronous FilterChain execution's sample code.
----
public NextAction handleRead(final FilterChainContext ctx) throws
IOException {
    final NextAction suspendActipn = ctx.getSuspendAction();
    ...
    return suspendActipn;
}
----
-->
----
    final NextAction suspendAction = ctx.getSuspendAction();
    ...
    return suspendAction;
----
* http://grizzly.java.net/nonav/docs/docbkx/html/ch04s04.html
- Figure4.1 doesn't have a image.
* http://grizzly.java.net/nonav/docs/docbkx/html/ch05s02.html
- this page doesn't have images.
================
I didn't file a issue in JIRA(http://java.net/jira/browse/GRIZZLY) because
I think these are trivial issue.
I hope this comment would help you.
Thanks.
Regards,
Bongjae Chang
On 11. 2. 15. ¿ÀÀü 11:43, "Ryan Lubke" <ryan.lubke_at_oracle.com> wrote:
>Hey Folks,
>
>We're following up on our original message about the documentation
>efforts for Grizzly 2.0.
>
>I'm happy to report that we've made decent progress on this effort,
>however, before Grizzly 2.0
>goes final, it would be great if the community could review the
>documentation [1] in an effort
>to find errors or offer suggestions on how to improve it.
>
>Please log any bugs/suggestions on JIRA [2] using the documentation
>component
>and we'll address them as quickly as possible.
>
>[1] http://grizzly.java.net/nonav/docs/docbkx/html/grizzly-docs.html
>[2] http://java.net/jira/browse/GRIZZLY
>
>On 9/2/10 10:43 AM, Ryan Lubke wrote:
>>  Hey Folks,
>>
>> In our Grizzly meeting two weeks ago, we decided that documentation
>> should be a primary goal for the initial 2.0 release.
>>
>> We think that creating this documentation using LaTeX or Docbook will
>> provide a lot of benefit as far as how we can distribute the
>> documentation (online, bundled, etc).
>>
>> We'd like to poll the community on topics they would like to see
>> covered in addition to the items I've listed below:
>>
>>   - core framework
>>   - http framework
>>   - web container framework
>>
>> Keep in mind, that we still need to start our outlines of what we
>> think should be covered in these areas, so once we've gathered
>> feedback we can incorporate the changes and produce the final outlines
>> for review.
>>
>> Once the outlines are approved, we can being writing the documentation
>> in earnest.
>>
>> Thanks,
>>
>> -rl
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe_at_grizzly.dev.java.net
>> For additional commands, e-mail: dev-help_at_grizzly.dev.java.net
>>
>