On 10/10/08 11:45 AM, Paul Davies wrote:
> Hi,
>> 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.
> Well, it might not help *your* reviewer, but that's no reason to omit
> information that reviewers who are following the review process as
> originally conceived might find useful. Remember, the whole point of
> using the wiki, rather than private email exchanges, for reviews is to
> keep the review process open and visible to the entire community.
> Assisting reviewers in not even looking at the wiki undermines this
> process.
>> I notice that if people have to scroll before they see any meat, they
>> think it's not there.
> Perhaps one could put the instructions *after* the "meaty" links, and
> maybe include a meaty link to the instructions.
>> We are so impatient now, we fly off to something else before looking
>> (or reading) what's right there.
> And how can we mitigate the effects of such impatience? The best we
> can do, I think, is to redirect the impatient reviewer to helpful
> information that they might have initially overlooked. As writers, we
> know that nobody reads the docs *unless they have to*.
>
>> 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
> It's not a question of love of words. It's more a question of words
> being necessitated by counterintuitive user interfaces. Unfortunately,
> the limitations of technology that we are using to conduct these
> reviews require words to explain how to overcome these limitations. In
> the absence of better technology, I don't see what else we can do.
I've used the GlassFish docs wiki and the wikis.sun.com wiki, and I find
the wikis.sun.com technology to be much easier to use IMHO, of course.
I suppose we're committed to this one now, though, but for future use,
it might be useful to look into other options.
Debbie
>
> Regards,
> -Paul
>
>>>> 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
>>>
>