Welcome to Telelogic Product Support
  Home Downloads Knowledgebase Case Tracking Licensing Help Telelogic Passport
Telelogic Rhapsody (steve huntington)
Decrease font size
Increase font size
Topic Title: 6.0 HTML manual not as good as PDF
Topic Summary:
Created On: 26-Jul-2005 21:04
Status: Read Only
Linear : Threading : Single : Branch
Search Topic Search Topic
Topic Tools Topic Tools
Subscribe to this topic Subscribe to this topic
E-mail this topic to someone. E-mail this topic
Bookmark this topic Bookmark this topic
View similar topics View similar topics
View topic in raw text format. Print this topic.
 26-Jul-2005 21:04
User is offline View Users Profile Print this message


Charlie Lane

Posts: 18
Joined: 11-May-2005

I wonder if I am the only one to find the 6.0 HTML manual and help is slower to use than the PDF and Windows-help? It seems slower to load and slower to navigate around. Perhaps I'm pushing the limits of my 1GHz PC?

I'm considering changing my list of books to point to PDF versions of the user manual etc that I have downloaded, because it's so much quicker to access information in the PDF compared with the HTML versions.

Any other views?
Report this to a Moderator Report this to a Moderator
 29-Jul-2005 18:22
User is offline View Users Profile Print this message


Josh Blash

Posts: 20
Joined: 17-Oct-2007

Charlie,
Slower to initially load or slow even when the help browser is already running?

Also, do you find the search functionality to be any better?

Ray
Report this to a Moderator Report this to a Moderator
 4-Aug-2005 13:32
User is offline View Users Profile Print this message


Richard Thumann

Posts: 5
Joined: 28-Mar-2005

For me its a preference issue. The 'one page' at time view of the HTML is limiting when I'm 'just learning' about a feature.
We have another product in house that has both. I use the pdf or a hard copy to 'learn' something, but will refere to html or online help for a quick answer.
Report this to a Moderator Report this to a Moderator
 10-Aug-2005 15:50
User is offline View Users Profile Print this message


Richard Amenta

Posts: 5
Joined: 23-May-2005

I've referred back to the 5.2 PDF documentation simply because there is information in there that is not in the HTML documentation. This is particularly true when referring to the OXF framework documentation. Some examples would be extrememly handy.
Report this to a Moderator Report this to a Moderator
 14-Oct-2005 10:50
User is offline View Users Profile Print this message


Charlie Lane

Posts: 18
Joined: 11-May-2005

Sorry to be so slow in putting flesh on the previous brief comment. The following is really in response to Ray's question about what is slower in the new HTML-based help.

Here are the tests I did:

a) From Rhapsody menus, find the section in the user guide on state charts.
In version 5.0.1 it takes 10 sec at most to load Acrobat and get the user guide, then maybe a further 10 sec to click to the section on state charts. Total about 20 sec, with things obviously happening all the time.
In 6.1 it takes a good 40 sec to load the help and get the index. It then took a further 34 sec to go to the S part of the index, scroll down and get the section on state charts. Total about 1 min 14 sec, with times when nothing was happening on screen.
(And the index list is wrongly formatted -- indenting seems haywire).

b) From Rhapsody menus, find the information in the COM API about IRPPackage.
In version 5.0.1 it takes under 4 sec to load the classical-style help and maybe another 10 sec to type in IRPPackage, search and go to the section. Total about 14 sec.
In version 6.1 it takes about 10 sec to load, click Search and get the search box. Then a further 15 sec to type in IRPPackage, search and go to the section. Total about 25 sec.
(And the IRPPackage entry doesn't make it easy to go to the parent class, which was a hotlink in the 5.0.1 help.)

c) From Rhapsody menus, find the showlabels property in the property reference.
In version 5.0.1 it takes maybe 10 sec to load Acrobat and get the property reference. Then a further 5 sec for Ctrl-F find showlabels, which is the entry in the index, and click to go to the relevant section. Total about 15 sec.
In version 6.1 it takes 10 sec to load, click Search and get the search box. Then a further 11 sec to type in showlabels, search in the property reference and go to the section. Total about 21 sec. (This may be less than the result from b because some of the html pages are cached?).

In addition to the timings, the new HTML help interface seems more cumbersome: I seem to be doing more clicks and waiting more.

I have taken to using the 6.0 PDF files (which I downloaded) as a quicker route than using the HTML-based help. I note that the PDF files are not yet available to download in an update for 6.1. Hopefully this will be available soon?
Report this to a Moderator Report this to a Moderator
 14-Oct-2005 18:57
User is offline View Users Profile Print this message


Bernhard Merkle

Posts: 18
Joined: 2-Jun-2005

I remember we talked about this issue at the Ilogix user conference in germany already...
so it seems you are not the only one with the impression ;-)

kind regards,
Bernhard.
Report this to a Moderator Report this to a Moderator
 8-Dec-2005 15:23
User is offline View Users Profile Print this message


David Butler

Posts: 1
Joined: 14-Sep-2005

For the record, I agree with the previous comment that both PDF and HTML would be very useful. I'm not sure why this approach would not be viewed as a "no brainer".
Report this to a Moderator Report this to a Moderator
 22-Dec-2005 18:31
User is offline View Users Profile Print this message


Ray Blash

Posts: 14
Joined: 22-Jul-2004

Here is an update on this topic.

Based upon the feedback in this thread and the responses to our recent on-line customer survey relative to documentation, we have made the following changes in Rhapsody 6.1 MR1, which is scheduled to be released in a few weeks:

· The List of Books contains a note on how to utilize the enhanced Adobe PDF folder search function. For those that may be unaware, this dramatically improves the search speed and provides more advanced (Boolean) search features. We recommend the use of the latest version of Adobe Acrobat Reader, which can be downloaded free from [url]www.adobe.com[/url].

· More books are available in both formats (HTML and PDF) than in previous releases. The 6.1 MR1 PDF manuals will also all be available in the Client Center of our Website.

· Added/enhanced over 200 context sensitive Help links.


For our release in mid-2006, we are working on a new approach for the property definitions location and display. I note this, as some of you would like a better way to be aware of all the Rhapsody properties and their specific function.

We have timed the searches and could not replicate the kind of slow response times noted. If anyone is experiencing this issue, we would like some feedback on your PC configuration. i.e.: processor, memory, etc. Looks like Charlie is using a 1GHZ machine and this could be an issue.

We are also looking to improve the search engine functionality in the HTML Help.

Btw, any specific feedback on the formatting or in general the way the HTML Help is displayed?
Report this to a Moderator Report this to a Moderator
 9-Mar-2006 22:13
User is offline View Users Profile Print this message


Javier Arroyo

Posts: 1
Joined: 2-Jun-2005

I am sorry to say that I do not like the HTML version either. One of the things I particularly dislike is that after you find some particluar information item via the search function, you can read it but you cannot put it in context, at least I cannot find out where that particular chapter falls within the enclosing book.
Get back to good ole PDF, please!
Report this to a Moderator Report this to a Moderator
 10-Mar-2006 16:55
User is offline View Users Profile Print this message


Jason Green

Posts: 1
Joined: 24-Oct-2005

Hello Javier. There is a button you can click that will show you the context of the search results. The button is pointed out with a red arrow in the first graphic attached. The second graphic shows you the search results in context.

-Jason



[QUOTE=Javier.Arroyo@casa.eads.net]I am sorry to say that I do not like the HTML version either. One of the things I particularly dislike is that after you find some particluar information item via the search function, you can read it but you cannot put it in context, at least I cannot find out where that particular chapter falls within the enclosing book.
Get back to good ole PDF, please![/QUOTE]

Image3.jpg
Image3.jpg  (147 KB)
Image2.jpg
Image2.jpg  (108 KB)

Report this to a Moderator Report this to a Moderator
Statistics
20925 users are registered to the Telelogic Rhapsody forum.
There are currently 1 users logged in.
You have posted 0 messages to this forum. 0 overall.

FuseTalk Standard Edition v3.2 - © 1999-2009 FuseTalk Inc. All rights reserved.