You are here: Foswiki>Tasks Web>Item752 (16 Mar 2011, GeorgeClark)Edit Attach

Item752: SEARCH $summary needs to be better at removing TML

Priority: Normal
Current State: Proposal Required
Released In: n/a
Target Release: n/a
Applies To: Engine
Component: SEARCH, FoswikiUsability
Reported By: SvenDowideit
Waiting For:
Last Change By: GeorgeClark
several have summaries that are really unhelpful to the user - shouldn't be too hard to remove TML?

-- SvenDowideit - 13 Jan 2009

We have a lot of history around $summary. Some in closed T bugs. We still have this open Item1376 which also lists some concerns about changing spec and a proposal for enhancement to meet exactly the requirement for this problem.

Also checkout

And many more

There is a huge trap recreating above and new problems by changing behavior of the $summary. So we have to be very very careful.

Maybe we fix the category views a tiny bit but we can easily break many of peoples applications.

Personally I find the Category searches totally useless in our documentation. We try and make a $summary be part of the top level navigation topics. In my view such a feature is only useful in free text searches where people search for anything and need to evaluate the result. But thinking that we get anything useful out of it in a formatted search is wrong. Either we should maintain these category topics manually and organize them in a way that fit humans. Or we should place a one liner description in each distributed document and show this line in the search result. No matter how we resolve this bug item the Category topics will remain a list of topics with useless summaries.

-- KennethLavrsen - 13 Jan 2009

I disagree that the category is useless - I use the ones we have in our docco alot - and i think its important that we support different kinds of ways into the info.

the one liner description idea - good reminder - we discussed this, and topic title a few times, but didn't act - except for the SHORTDESCIPTION se use on Extensions.

Your list of past failing attempts is appreciated - we will obviously need to be careful and clever.

in summary, I do not thing we should do one or the other, i think we should do all.

-- SvenDowideit - 16 Jan 2009

AdminToolsCategory has been changed to not use a search. Removing the reference from the Summary. And from the above, sounds like a proposal would be required.

-- GeorgeClark - 16 Mar 2011

ItemTemplate edit

Summary SEARCH $summary needs to be better at removing TML
ReportedBy SvenDowideit
SVN Range Foswiki-1.0.0, Thu, 08 Jan 2009, build 1878
AppliesTo Engine
Component SEARCH, FoswikiUsability
Priority Normal
CurrentState Proposal Required
TargetRelease n/a
ReleasedIn n/a
Topic revision: r5 - 16 Mar 2011, GeorgeClark - This page was cached on 21 Jan 2021 - 12:37.

The copyright of the content on this website is held by the contributing authors, except where stated elsewhere. See Copyright Statement. Creative Commons License    Legal Imprint    Privacy Policy