Misleading statistics in Analyzer....

This forum is for all Analyzer issues related to procedural steps, tips and tricks.
Post Reply
rkiskan
Propeller Head
Posts: 30
Joined: Fri Feb 03, 2006 4:56 am
Location: Denmark

Misleading statistics in Analyzer....

Post by rkiskan »

I have discovered something that very nearly caused serious damage to my project. I ran an analysis on a project of about 350 topics. I received a result saying that approximately 30 topics were "unused". In my interpretation that is like having images that aren't referenced anywhere, so just delete them. Bad idea!

Unused topics in Analyzer can include topics that link out to other topics, but aren't lnked to. In this specific project I make context sensitive calls from the application to these 30 topics, and these topics link into other parts of the Help file, but they aren't linked to and they aren't in the TOC or index. Deleting them would have seriously affected the functionality of the application --- so be cerafull. Ideally Analyzer should not regards these as unused topics.

Robin
SteveS
Senior Propellus Maximus
Posts: 2087
Joined: Tue Mar 07, 2006 5:06 pm
Location: Adelaide, far side of the world ( 34°56'0.78\"S 138°46'44.28\"E).
Contact:

Re: Misleading statistics in Analyzer....

Post by SteveS »

Hi Robin,

Make sure you lodge a bug report on this one!
Image
Steve
Life's too short for bad coffee, bad chocolate, and bad red wine.
RamonS
Senior Propellus Maximus
Posts: 4293
Joined: Thu Feb 02, 2006 9:29 am
Location: The Electric City

Re: Misleading statistics in Analyzer....

Post by RamonS »

I understand the confusion, but then what does constitute an unused help topic? In order to really analyze this exactly the application code needs to be evaluated. Maybe calling these topics "unreferenced topics" may be better than "unused".
LTinker68
Master Propellus Maximus
Posts: 7247
Joined: Thu Feb 16, 2006 9:38 pm

Re: Misleading statistics in Analyzer....

Post by LTinker68 »

Just out of curiosity, do you have these topics mapped in the alias file? I don't use CSH calls using the alias and IDs, but I'm curious as to whether Analyzer sees that mapping and identifies the topic as being used?
Image

Lisa
Eagles may soar, but weasels aren't sucked into jet engines.
Warning! Loose nut behind the keyboard.
rkiskan
Propeller Head
Posts: 30
Joined: Fri Feb 03, 2006 4:56 am
Location: Denmark

Re: Misleading statistics in Analyzer....

Post by rkiskan »

Ok, I have reported this as an issue.

No, we do not have any MAP IDs on the topics. Basically it's a project imported frm X5 and the application uses URLs with specific HTML file names, so we didn't want to update the app. - that may change though.

Robin
NorthEast
Master Propellus Maximus
Posts: 6359
Joined: Mon Mar 05, 2007 8:33 am

Re: Misleading statistics in Analyzer....

Post by NorthEast »

I'm not sure I agree. To Flare these topics will appear to be unused, as the user cannot navigate to them in the help system. The fact they have outward links isn't that important.
The way you're displaying them is to link to them directly (not using Flare's CSH), so how would Flare know that they're "used"?

I wouldn't like this feature to change, I want Flare to tell me about topics that aren't linked to - that's the fundamental characteristic of redundant topics in my projects.
RamonS
Senior Propellus Maximus
Posts: 4293
Joined: Thu Feb 02, 2006 9:29 am
Location: The Electric City

Re: Misleading statistics in Analyzer....

Post by RamonS »

That is why I think that adjusting the wording may satisfy both sides, although I didn't get the impression as that there was really a full intention to have this feature removed.
NorthEast
Master Propellus Maximus
Posts: 6359
Joined: Mon Mar 05, 2007 8:33 am

Re: Misleading statistics in Analyzer....

Post by NorthEast »

Well, it's been reported as an issue. I disagree that there's a problem with the way the feature works, it's more the way it was used.

Analyzer can only do so much. You have to decide whether the topics that it thinks are unused should be deleted or not, so if you delete them without checking first then it's your own fault.
Post Reply