Re: [web] derby web site reorg -> Navigating the manuals online

["Jean T. Anderson" <jt...@bristowhill.com>]

David W. Van Couvering wrote:
> I actually really don't care how it's solved, having it all in one book
> was just one idea.  My definition of "book" maybe should be called a
> "compendium" or something - a collection of books.
> 
> The main point I wanted to make was that you can easily go from one
> Derby document (Developer's Guide, for example) to another (Reference,
> for example) without five clicks to navigate through the hierarchy again.

Please try this:

http://people.apache.org/~jta/DerbyTest/manuals/index.html#Latest+Alpha+Manuals

I put the links in a table, and each opens the linked-to page in a new
window, leaving the original window as is. You no longer have to hit the
back button to traverse the hierarchy. You can simply close the current
window, then select the new manual.

Does this help?

thanks,

 -jean

> David
> 
> scott hutinger wrote:
> 
>> David W. Van Couvering wrote:
>>
>>> Sorry, I described the problem wrong (I had it a bit mixed up in my
>>> head)
>>>
>>> Say I go to Manuals->English->10.1 Manuals->Developers Guide->HTML
>>> Files
>>>
>>> Then I go "hmmm, maybe what I'm looking for is in the Reference
>>> Guide".  I can't just go to this, I have to go Back, and then click
>>> English->10.1 Manuals->Reference->HTML Files
>>>
>>> I'd love to just be able to go straight to the HTML files version
>>> of the 10.1 Reference guide (one click instead of five clicks).
>>>
>>> Maybe one way to solve this is to have *all* the documents in a
>>> single combined book.
>>
>>
>>
>> I'm a bit confused about a single combined book.  Are you saying
>> something along the lines of the sun docs being in book form, or
>> something else?  I think what your saying is all docs are 1 (one), is
>> that correct ?
>>
>> Would that be 1 book for all information, meaning a intro book
>> (although 1) that leads to all other sub-categories?  I know what you
>> are saying is very direct, but I am a bit uncertain at this time about
>> a build that would work(?) for the docs being 1(one).  Although I am
>> certain this could happen, could you give a bit more information :-) ?
>>
>>> David
>>>
>>> Jean T. Anderson wrote:
>>>
>>>> David W. Van Couvering wrote:
>>>>
>>>>
>>>>> Hi, Jean, after a quick look, I like all the changes you made!
>>>>>
>>>>> The one thing that regularly bothers me, to be frank, is that
>>>>> in the documentation where you look at it as an HTML book, you
>>>>> can't go back in your link path.  You always have to start over
>>>>> and navigate down from the top.  I am assuming that's a DITA
>>>>> bug?
>>>>
>>>>
>>>>
>>>> I'm not sure I understand. Could you give an example? i.e.,
>>>> provide an url then describe what you'd like to do.
>>>>
>>>> thanks,
>>>>
>>>> -jean
>>>>
>>>> <snipped>
>>>
>>>
>>
>>

Re: [web] derby web site reorg -> Navigating the manuals online

["David W. Van Couvering" <Da...@Sun.COM>]

Yes, this works!  I can't say for sure without extended usage whether 
the separate browser window for each manual works or not, but my first 
impression is that this is *very* helpful.

Thanks!

David

Jean T. Anderson wrote:
> David W. Van Couvering wrote:
> 
>>I actually really don't care how it's solved, having it all in one book
>>was just one idea.  My definition of "book" maybe should be called a
>>"compendium" or something - a collection of books.
>>
>>The main point I wanted to make was that you can easily go from one
>>Derby document (Developer's Guide, for example) to another (Reference,
>>for example) without five clicks to navigate through the hierarchy again.
> 
> 
> Please try this:
> 
> http://people.apache.org/~jta/DerbyTest/manuals/index.html#Latest+Alpha+Manuals
> 
> I put the links in a table, and each opens the linked-to page in a new
> window, leaving the original window as is. You no longer have to hit the
> back button to traverse the hierarchy. You can simply close the current
> window, then select the new manual.
> 
> Does this help?
> 
> thanks,
> 
>  -jean
> 
> 
>>David
>>
>>scott hutinger wrote:
>>
>>
>>>David W. Van Couvering wrote:
>>>
>>>
>>>>Sorry, I described the problem wrong (I had it a bit mixed up in my
>>>>head)
>>>>
>>>>Say I go to Manuals->English->10.1 Manuals->Developers Guide->HTML
>>>>Files
>>>>
>>>>Then I go "hmmm, maybe what I'm looking for is in the Reference
>>>>Guide".  I can't just go to this, I have to go Back, and then click
>>>>English->10.1 Manuals->Reference->HTML Files
>>>>
>>>>I'd love to just be able to go straight to the HTML files version
>>>>of the 10.1 Reference guide (one click instead of five clicks).
>>>>
>>>>Maybe one way to solve this is to have *all* the documents in a
>>>>single combined book.
>>>
>>>
>>>
>>>I'm a bit confused about a single combined book.  Are you saying
>>>something along the lines of the sun docs being in book form, or
>>>something else?  I think what your saying is all docs are 1 (one), is
>>>that correct ?
>>>
>>>Would that be 1 book for all information, meaning a intro book
>>>(although 1) that leads to all other sub-categories?  I know what you
>>>are saying is very direct, but I am a bit uncertain at this time about
>>>a build that would work(?) for the docs being 1(one).  Although I am
>>>certain this could happen, could you give a bit more information :-) ?
>>>
>>>
>>>>David
>>>>
>>>>Jean T. Anderson wrote:
>>>>
>>>>
>>>>>David W. Van Couvering wrote:
>>>>>
>>>>>
>>>>>
>>>>>>Hi, Jean, after a quick look, I like all the changes you made!
>>>>>>
>>>>>>The one thing that regularly bothers me, to be frank, is that
>>>>>>in the documentation where you look at it as an HTML book, you
>>>>>>can't go back in your link path.  You always have to start over
>>>>>>and navigate down from the top.  I am assuming that's a DITA
>>>>>>bug?
>>>>>
>>>>>
>>>>>
>>>>>I'm not sure I understand. Could you give an example? i.e.,
>>>>>provide an url then describe what you'd like to do.
>>>>>
>>>>>thanks,
>>>>>
>>>>>-jean
>>>>>
>>>>><snipped>
>>>>
>>>>
>>>
>