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) <[email protected]>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. > >
