openjpa-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Michael Dick <michael.d.d...@gmail.com>
Subject Re: [jira] Created: (OPENJPA-897) OpenJPA Documentaion should provide better navigation
Date Wed, 04 Feb 2009 20:46:14 GMT
Hi Kevin,

Did you get a 404, or is it a case of the page not looking right? Pinaki
mentioned his changes to me and I triggered an early build of the doc
(normally it kicks off overnight). The build finished just after your email
(around 2:37) so you might have just missed the page.

I took a look a couple min ago and the page is there, but looks like it's
missing some images.

-mike

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

> 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