Mailing-List: contact dev-help@openjpa.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@openjpa.apache.org
Received-SPF: pass (athena.apache.org: domain of kwsutter@gmail.com designates
 209.85.200.170 as permitted sender)
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=gamma;
        h=mime-version:in-reply-to:references:date:message-id:subject:from:to
         :content-type;
        b=toJt1qJubzjPkrimupjzB+bTWQ3HvKXRrBxU9G6WquAG+/VLkQIETM3iyDVuuaJEix
         AdGuuhSo2MAFJ0JkypJVI7DfFpjlC5/DgBYi7M0aEnh1+LZ/qs2rbMC4uA3z5wkfvHk7
         2T65HTe6e0536wrwoZNzQlT63xIH5m5T7pd6o=
MIME-Version: 1.0
In-Reply-To: <89c0c52c0902041222u7e11112ev8a7fd77d92f6020b@mail.gmail.com>
References: <669923715.1233769679617.JavaMail.jira@brutus>
	 <89c0c52c0902041222u7e11112ev8a7fd77d92f6020b@mail.gmail.com>
Date: Wed, 4 Feb 2009 14:34:08 -0600
Message-ID: <89c0c52c0902041234w6d13da20q5de227a7500db595@mail.gmail.com>
Subject: Re: [jira] Created: (OPENJPA-897) OpenJPA Documentaion should provide
	better navigation
From: Kevin Sutter <kwsutter@gmail.com>
To: dev@openjpa.apache.org
Content-Type: multipart/alternative; boundary=001636e1fcd9b5e45d04621db545

--001636e1fcd9b5e45d04621db545
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit

Looks like the link to the manual isn't working right:

http://openjpa.apache.org/builds/latest/docs/manual/main.html


On Wed, Feb 4, 2009 at 2:22 PM, Kevin Sutter <kwsutter@gmail.com> wrote:

> Pinaki,
> Any attempt to improving our documentation navigation is welcomed, but I
> can't figure out how to view your proposed changes.  Are you expecting us to
> download your changes and re-build the documentation?  Could you provide a
> link to a pre-built version so that we could just "experience" it?
>
> Thanks,
> Kevin
>
>
> On Wed, Feb 4, 2009 at 11:47 AM, Pinaki Poddar (JIRA) <jira@apache.org>wrote:
>
>> OpenJPA Documentaion should provide better navigation
>> -----------------------------------------------------
>>
>>                 Key: OPENJPA-897
>>                 URL: https://issues.apache.org/jira/browse/OPENJPA-897
>>             Project: OpenJPA
>>          Issue Type: Improvement
>>            Reporter: Pinaki Poddar
>>
>>
>> Navigating from Table of Contents in OpenJPA web-based documentation is
>> not very user-friendly. On the chunked version, you click a topic link in
>> TOC and you go to a new page altogether.
>> It can be easier if TOC topics always appeared in a left-sided
>> Navigational Panel.
>> With my very limited skill on such matters, I have assembled a draft
>> solution based on HTML Frame. Given that HTML Frames are not always
>> supported by a browser, the fallback option is what it used to be.
>> The changes can be found in [1,2].
>>
>> Because what is a 'user-friendly' navigation style of web-based document
>> is a pretty subjective choice, please check if you prefer this new style or
>> not.
>>
>> If I hear lots of nays, the change will be rolled back.
>>
>> Even if the style is accepted, given my very limited knowledge of XSL,
>> HTML and other animals found in the web, some of you may suggest a much
>> better way of achieving the same purpose.
>>
>> [1] http://svn.apache.org/viewvc?view=rev&revision=740805
>> [2]
>> http://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=23626&originalVersion=19&revisedVersion=20
>>
>>
>>
>> --
>> This message is automatically generated by JIRA.
>> -
>> You can reply to this email to add a comment to the issue online.
>>
>>
>

--001636e1fcd9b5e45d04621db545--