Hi Manfred,
Thanks for your reviews - your comments are right on and very helpful.
Regarding the filing of issues, it is a bit tricky. Filing one issue per
comment might be too much overhead for you and the writer, whereas
filing all comments in a single issue also isn't a perfect solution.
I spoke with the writer about this, and if it works for you, the
preference is to record all comments for a particular entity (tree, tab,
etc.) in a single issue, similar to what you've done in your e-mails.
Thanks,
Gail
++++++
GlassFish Documentation
Judy Tang wrote:
> Hi Manfred,
>
> You can choose what makes easy for you and for writer. One email per
> issue sounds good to me :-)
>
> Thanks,
> Judy
>
> Manfred Riem wrote:
>
>> Hi Judy,
>>
>>
>>
>> Do you want an issue for each page (section in this email?)
>>
>>
>> Manfred
>>
>>
>>
>> *From:* Judy.J.Tang_at_Sun.COM [mailto:Judy.J.Tang_at_Sun.COM]
>> *Sent:* Wednesday, August 27, 2008 9:53 PM
>> *To:* quality_at_glassfish.dev.java.net
>> *Subject:* Re: [Documentation] Glassfish V3 Admin console - Http
>> Service Tab
>>
>>
>>
>> Hi Manfred,
>>
>> Thank you so much for reviewing the doc. You pointed out places where
>> the doc needs to give more explanation
>> on what the function does, it is really good input !
>>
>> Would you please log issue for each review email you sent. When the
>> issue got fixed, you can verify the fix.
>>
>> Thanks,
>> Judy
>>
>> Manfred Riem wrote:
>>
>> Hi there,
>>
>>
>>
>> Each section is separated by a line, note this
>>
>> review is done against nightly 20080826.
>>
>>
>>
>>
>>
>>
>>
>> http://localhost:4848/html/en/help/ref-httpservice.html
>>
>> http://localhost:4848/html/en/help/task-httpservice.html
>>
>>
>>
>> ** Almost identical content and meaning.
>>
>>
>>
>>
>>
>>
>>
>> http://localhost:4848/html/en/help/ref-httpservice.html
>>
>>
>>
>> traceEnabled
>>
>>
>>
>> If set to true, enables the TRACE operation. Set this property to
>> false to make the Enterprise Server less susceptible to cross-site
>> scripting attacks.
>>
>> Default is true.
>>
>> What does the TRACE operation do? Please link it to an explanation or
>> provide the explanation here.
>>
>>
>>
>> The HTTP Service stores static content to enable the Enterprise Server
>> to process requests for static content quickly.
>>
>> ** Does it?
>>
>>
>>
>> To Configure HTTP Service Request Processing
>> <http://localhost:4848/html/en/help/task-requestprocessing.html>
>>
>>
>>
>> ** Change to: To Configure The HTTP Service Request Processing
>> <http://localhost:4848/html/en/help/task-requestprocessing.html>
>>
>>
>>
>> http://localhost:4848/html/en/help/task-requestprocessing.html
>>
>> The HTTP Service Request Processing stores static content to enable
>> the Enterprise Server to process requests for static content quickly.
>>
>> ** Does it?
>>
>>
>>
>> http://localhost:4848/html/en/help/task-keepalive.html
>>
>> The HTTP Service Keep-Alive stores static content to enable the
>> Enterprise Server to process requests for static content quickly.
>>
>> ** Does it?
>>
>>
>>
>> http://localhost:4848/html/en/help/task-connectionpool.html
>>
>> The HTTP service connection pool stores static content to enable the
>> Enterprise Server to process requests for static content quickly.
>>
>> ** Does it?
>>
>>
>>
>> http://localhost:4848/html/en/help/task-httpprotocol.html
>>
>> The HTTP Protocol stores static content to enable the Enterprise
>> Server to process requests for static content quickly.
>>
>> ** Does it?
>>
>> Accepted values are HTTP/1.0 and HTTP/1.1
>>
>> ** What is the default?
>>
>>
>>
>> http://localhost:4848/html/en/help/task-httpfilecache.html
>>
>> The HTTP file cache stores static content to enable the Enterprise
>> Server to process requests for static content quickly.
>>
>> ** Reword this to caches static content …..
>>
>> (Windows platform only) Select the File Transmission Enabled checkbox
>> to enable the use of the TransmitFile() system call .
>>
>> ** Explain what this does, and if it helps running on Windows.
>>
>>
>>
>>
>>
>