Mailing-List: contact dev-help@openjpa.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@openjpa.apache.org
Message-ID: <669923715.1233769679617.JavaMail.jira@brutus>
Date: Wed, 4 Feb 2009 09:47:59 -0800 (PST)
From: "Pinaki Poddar (JIRA)" <jira@apache.org>
To: dev@openjpa.apache.org
Subject: [jira] Created: (OPENJPA-897) OpenJPA Documentaion should provide
 better navigation
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit

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.