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:22:58 GMT
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