On 10/09/08 17:31, Gail Risdal wrote:
> Good idea - I'll add it. I'll also add instructions to the Wiki FAQ.
>
> Gail
>
> Paul Davies wrote:
>
>> And maybe the instructions could also be included on the main doc
>> comment wiki page.
I don't think this will help at all. My reviewer didn't even look on the
AG page, much less the main doc comment page with more lines that will
push the meaty links out of view. I notice that if people have to scroll
before they see any meat, they think it's not there. We are so impatient
now, we fly off to something else before looking (or reading) what's
right there. Doc people need to face that and stop putting so much
non-meat at the top of a page. We love words too much.
IMHO
>> On 10/09/08 17:02, Gail Risdal wrote:
>>
>>> Hello,
>>>
>>> Per the question below, I think all of our doc comment wiki pages
>>> should have instructions about how to access the attachments. I know
>>> some of them already do, but for the rest, could you add that info
>>> to your respective pages when you have a chance?
>>>
>>> Other reviewers might be having trouble with this but just aren't
>>> asking about it - we certainly don't want to put up roadblocks or
>>> discourage anyone from doing a review.
>>>
>>> Thanks,
>>> Gail
>>>
>>> -------- Original Message --------
>>> Subject: Re: missing document in GlassFish wiki
>>> Date: Thu, 09 Oct 2008 16:55:39 -0700
>>> From: Gail Risdal <Gail.Risdal_at_Sun.COM>
>>> Reply-To: users_at_glassfish.dev.java.net
>>> Organization: Sun Microsystems
>>> To: users_at_glassfish.dev.java.net
>>> References:
>>> <730700800810091532h58e681efie57018444fe154c6_at_mail.gmail.com>
>>>
>>> Hi Sarah,
>>>
>>> I agree - it's not that easy to find the attachments! Here's what you
>>> need to do (and we'll make this clearer on those review pages):
>>>
>>> 1. On the wiki page for a particular doc, click the Attachments link at
>>> the bottom of the page.
>>> 2. In the "List of attachments" box, select the .pdf file (the file
>>> name
>>> for the JRuby attachment, for instance, is JRUBYAPPDG.pdf).
>>> 3. In the "Image preview" box, click "Click to load attachment." The
>>> PDF
>>> is displayed. (No, not very intuitive! Or, to put it another way,
>>> intuitive once someone points it out to you.)
>>>
>>> Hope this helps.
>>>
>>> Gail
>>> ++++++
>>> GlassFish Documentation
>>>
>>> Sarah kho wrote:
>>>
>>>> Hi
>>>>
>>>> Thank you for reading my post
>>>>
>>>> I think some documents are missing from GlassFish wiki for example
>>>> in
>>>> http://wiki.glassfish.java.net/Wiki.jsp?page=JRubyOnRailsForGlassFish
>>>>
>>>> it clearly says that "The June 2008 version of this document is
>>>> available in PDF format as an attachment to this page. This version
>>>> applies to GlassFish v3 Technology Preview 2 (TP2)." but nothing is
>>>> attached to the page.
>>>>
>>>> many of GF V3 documentation pages has no PDF file attached while
>>>> they are talking about it.
>>>>
>>>> Thanks
>>>>
>>>
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: users-unsubscribe_at_glassfish.dev.java.net
>>> For additional commands, e-mail: users-help_at_glassfish.dev.java.net
>>>
>>>
>>>
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: docs-unsubscribe_at_glassfish.dev.java.net
>>> For additional commands, e-mail: docs-help_at_glassfish.dev.java.net
>>>
>>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docs-unsubscribe_at_glassfish.dev.java.net
> For additional commands, e-mail: docs-help_at_glassfish.dev.java.net
>