openjpa-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Kevin Sutter <kwsut...@gmail.com>
Subject Re: [jira] Created: (OPENJPA-897) OpenJPA Documentaion should provide better navigation
Date Wed, 04 Feb 2009 20:34:08 GMT
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.
>>
>>
>

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message