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
Branches:

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
Codebase
SVN Range	Foswiki-1.0.0, Thu, 08 Jan 2009, build 1878
AppliesTo	Engine
Component	SEARCH, FoswikiUsability
Priority	Normal
CurrentState	Proposal Required
WaitingFor
Checkins
TargetRelease	n/a
ReleasedIn	n/a