Thanks Wim for your valuble input. I agree with you and I will help to
follow up with doc team to see how to simplify
the doc review web page [1].
For now, you can find the following content in [2]. By click on the
link and then click on the "Attachment" in the bottom of the
page, you can start the review. Would you please give this a try :-)
[1]
http://wiki.glassfish.java.net/Wiki.jsp?page=Docreviewrule
[2]
http://wiki.glassfish.java.net/Wiki.jsp?page=GlassFishDocs
Guides and Tutorials - Ready for Review
* Administration Guide
<
http://wiki.glassfish.java.net/Wiki.jsp?page=AdministrationGuide>
* Administration Reference
<
http://wiki.glassfish.java.net/Wiki.jsp?page=AdministrationReference>
* Application Deployment Guide
<
http://wiki.glassfish.java.net/Wiki.jsp?page=ApplicationDeplyomentGuide>
* Developer's Guide
<
http://wiki.glassfish.java.net/Wiki.jsp?page=DeveloperSGuide>
* Quick Start Guide
<
http://wiki.glassfish.java.net/Wiki.jsp?page=QuickStartGuide>
* RESTful Web Services Developer's Guide
<
http://wiki.glassfish.java.net/Wiki.jsp?page=RESTfulWebServicesDevelopersGuide>
Online Help Sets - Ready for Review
* Administration CLI Online Help
<
http://wiki.glassfish.java.net/Wiki.jsp?page=AdministrationCLIOnlineHelp>
* Administration Console Online Help
<
http://wiki.glassfish.java.net/Wiki.jsp?page=AdministrationConsoleOnlineHelp>
* Update Center Online Help
<
http://wiki.glassfish.java.net/Wiki.jsp?page=UpdateCenterOnlineHelp>
Guides and Tutorials - Not Quite Ready for Review
* Installation Guide
<
http://wiki.glassfish.java.net/Wiki.jsp?page=InstallationGuide>
* Getting Started with JRuby on Rails for GlassFish v3
<
http://wiki.glassfish.java.net/Wiki.jsp?page=JRubyOnRailsForGlassFish>
* Getting Started with Project jMaki for GlassFish v3
<
http://wiki.glassfish.java.net/Wiki.jsp?page=JMakiForGlassFish>
* Java EE 5 Tutorial
<
http://wiki.glassfish.java.net/Wiki.jsp?page=JavaEE5Tutorial>
* Reference Manual
<
http://wiki.glassfish.java.net/Wiki.jsp?page=ReferenceManual>
* Release Notes
<
http://wiki.glassfish.java.net/Wiki.jsp?page=ReleaseNotes>
Wim Verreycken wrote:
>Hi Judy,
>
>I spent about 10 minutes on the doc review site. I was expecting, certainly
>after clicking the "contribute" link, to find a certain overview of review
>planning and documents currently to be reviewed. I couldn't find either (at
>least not without reading a lot of ...) within 10 minutes. Spent the other 2
>trying to find a document to review.
>
>I read that if I review 15 man pages this counts as a doc review (but not
>worried about my counter).
>About the online docs, that was a bit to much ... to read for a doc review.
>Main question, where are those docs?
>
>If I clicks on "contribute" I was expecting to see : sign up/sign in, review
>this, to be reviewed soon (planning).
>
>Have to admit I don't like doc reviews (had to do too many- don't ask). So
>if I should do this, at least the access should be fast no?
>
>Don't wan't to sound negative (I'm actually very positive about Java and Sun
>products in general), just wanted to mention my experience. I had hoped to
>have spent (after logging in) 2 minutes finding a document on a subject I
>know well(bundled or not, why can't I find them online if I want to review)
>and 10 to 15 to review about 10 to 15 pages.
>
>Maybe it's just me of course :)
>
>Wim
>-----Original Message-----
>From: Judy.J.Tang_at_Sun.COM [mailto:Judy.J.Tang_at_Sun.COM]
>Sent: donderdag 18 september 2008 17:31
>To: quality_at_glassfish.dev.java.net
>Subject: Re: [FishCAT] Updated Quick Start Guide, please help us review,
>thanks !
>
>Hi Jack,
>
>For GlassFish V3 Prelude doc review, you first click [1] to read FishCAT doc
>review rule. After
>that you can click [2], it list all the GlassFish V3 Prelude docs for
>review. [2] is inside [1]
>
>Would you please give this a try to see if you can find the doc you want to
>review easily :-)
>
>[1]http://wiki.glassfish.java.net/Wiki.jsp?page=Docreviewrule
>[2]http://wiki.glassfish.java.net/Wiki.jsp?page=GlassFishDocs
>
>Thanks,
>Judy
>jack_spallaw wrote:
>
>Good morining!
>
>
>I saw you post 7 very good review comments for "QuickStartGuide". Thanks !
>
>My pleasure.
>
>
>You asked about if there is a detail document of "Update Tool". I will
>ask around.
>
>Thank you, and I will keep seeking it too.
>
>As it now stands, I could find the "JavaDB" documentation.
>http://developers.sun.com/javadb/reference/docs/
>
>I think, it would be better off written the text below :
>"for detail : http://developers.sun.com/javadb/reference/docs/"
>into the page 7 "Starting and Stopping the Database Server" chapter.
>
>How do you think about this?
>
>
>Hi Jack,
>
>I saw you post 7 very good review comments for "QuickStartGuide". Thanks !
>
>You asked about if there is a detail document of "Update Tool". I will
>ask around.
>It would be good to for reviewing :-)
>
>Thanks,
>Judy
>
>jack_spallaw wrote:
>
>
>Hi Judy,
>
>I finish to post my comment for "QuickStartGuide".
>Please pick it up.
>
>Thanks
>Jack
>
>
>
>
>"If FishCAT members have to sign an SCA to review the unbundled docs,
>then let's allow them to submit issues as an optional alternative."
>
>Hi Survivant, I checked with doc team manager to simplify the FishCAT
>doc review process
>and above is his email reply. You no longer to sign the SCA to review
>the docs, you can just use
>the IssueTracker to log your review comments.
>
>Thanks for following the process. This is one thing I noticed every
>FishCAT member strictly
>following the process which makes FishCAT program so smooth. And we are
>open for suggestion
>to make the process efficient for every one :-)
>
>Thanks,
>Judy
>
>Survivant 00 wrote:
>
>
>
>I think that I need an autorization to write on the wiki. That will
>avoid someone to spam the wiki. I'll wait for further intructions
>
>2008/9/16 Judy Tang <Judy.J.Tang_at_sun.com <mailto:Judy.J.Tang_at_sun.com>>
>
> Hi Survivant,
>
> As an alternative, you can simply file an issue on doc.
> I confirmed this with doc team manager.
>
>
> Thanks,
> Judy
> Survivant 00 wrote:
>
>
>
> thanks.. because I really don't see a edit link even when logged.
>
>
>
> 2008/9/16 Judy Tang <Judy.J.Tang_at_sun.com
> <mailto:Judy.J.Tang_at_sun.com>>
>
> After you login, do you see "edit" feature on the bottom.
> Will ask doc team to help you if you.
>
>
> Thanks,
> Judy
>
> Survivant 00 wrote:
>
>
>
> I log into the wiki.. but where do I edit the page to put my
> comments ?
>
>
> 2008/9/16 Judy Tang <Judy.J.Tang_at_sun.com
> <mailto:Judy.J.Tang_at_sun.com>>
>
> "it's good.", we like to hear this, thanks Survivant for
> reviewing. Your suggestion is very good, would you please
> put in your comment below so doc team will follow up.
> Would like to hear more from other, what you like about
> this doc, what else you like to see in this doc ...
>
>
>
>
>
>
>http://wiki.glassfish.java.net/Wiki.jsp?page=QuickStartGuide
>
>
>
> Thanks,
> Judy
>
> Survivant 00 wrote:
>
>
>
> it's good..
>
> can you add a section where to get more advanced
> settings documentation ?
>
> I would like to read the starting guide and when I'm
> finish to be able to know where I should go to get more
> information.
>
>
> for now, I would like to know where to change the
> defaults ports, the default password, add listener..
> it's too advance for the starting guide, but I would
> like to know where to find it easily.
>
>
> You should post screenshot too. Some people are more
> visual than the others.
>
>
>
> 2008/9/16 Judy Tang <Judy.J.Tang_at_sun.com
> <mailto:Judy.J.Tang_at_sun.com>>
>
> Hi All,
>
> I have not seen any review comment back, I wonder
> if you have some time to help us review this doc.
>
> If you are new to GlassFish, this Quick Start Guide
> is written just for you. In total of 13 pages, you
> learn
> where to get GF V3, how to install it, how to start
> domain, start database, start Admin console, how to
> deploy, undeploy, and run application.
>
> Please get yourself a cup of tea, turn on your
> favorite music, start reading at same time help us
> reviewing this
> doc, after 30 minutes, you will feel you know so
> much about GlassFish :-)
>
> Here is the way to get this doc:
>
> (1) Click
>
>
>
>
>http://wiki.glassfish.java.net/Wiki.jsp?page=QuickStartGuide
>
>
>
> (2) In the bottom of the page, click "Attachments"
>
> (3) In "List of attachments" window, select the pdf
> file
>
> (4) In "Image Preview" window, click "Click to load
> attachment", you are all set to review this doc
>
> Thank you in advance for reviewing and we look
> forward to hearing your feedback !
>
> Thanks,
> Judy
>
> Gail Risdal wrote:
>
> Hello,
>
> Just wanted to let you know that an updated
> version of the Quick Start Guide is now
> available for review:
>
>
>
>
>http://wiki.glassfish.java.net/Wiki.jsp?page=QuickStartGuide
>
>
>
> Also, just a reminder that doc review
> schedules, guidelines, and other important
> details are on this page:
>
>
>
>
>http://wiki.glassfish.java.net/Wiki.jsp?page=Docreviewrule
>
>
>
> Thanks!
> Gail
> +++++
> GlassFish Documentation
>
>
>
>
>
>
>
>
>---------------------------------------------------------------------
>To unsubscribe, e-mail: quality-unsubscribe_at_glassfish.dev.java.net
>For additional commands, e-mail: quality-help_at_glassfish.dev.java.net
>
>
>
>
>
>---------------------------------------------------------------------
>To unsubscribe, e-mail: quality-unsubscribe_at_glassfish.dev.java.net
>For additional commands, e-mail: quality-help_at_glassfish.dev.java.net
>
>
>