/srv/irclogs.ubuntu.com/2008/09/29/#ubuntu-doc.txt

=== brik_ is now known as Brik
kirklandmdke: ping me when you get a few minutes tonight16:12
mdkekirkland: hiya21:13
kirklandmdke: hey there21:13
jjessehello mdke21:13
mdkehi jjesse21:13
kirklandmdke: once again, my apologies for the name slip...  50 lashes21:13
mdkekirkland: no worries!21:13
mdkekirkland: so I checked out the control panel to the search utility21:13
mdkethere seemed to be a problem with it though21:13
mdkelemme see now21:14
kirklandmdke: ?21:14
mdkewhen I click on the drop down "Included sites from Dustin Kirkland" it tells me "Loading Sites Failed"21:15
kirklandmdke: hmm, okay, this is new territory to me, i've never shared control21:16
kirklandmdke: i can see two sets of the sites indexed21:17
mdkeyeah, I was going to say that there is some repetition21:17
kirklandmdke: and I get the same javascripty error message21:17
mdkeon the homepage it lists each help site twice21:17
kirklandmdke: okay, i deleted the duplicate sites listed21:18
kirklandmdke: shall i throw up a page with the Ubuntu Documentation header/footer?21:19
kirklandmdke: and the custom search?21:19
kirklandmdke: (that part is the easy part)21:19
kirklandmdke: getting the results to look like you want is the hard part21:19
mdkekirkland: is it possible to get a search bar without the "Create your own Custom Search Engine" bit underneath?21:20
kirklandyeah21:20
kirklandone sec...21:20
kirklandmdke: http://people.ubuntu.com/~kirkland/helpsearch.html21:25
mdkeoh cool21:26
kirklandmdke: you could create a more custom results page21:26
kirklandmdke: i just splat/pasted help.ubuntu.com21:26
kirklandmdke: minus all the links, etc.21:26
mdkethat's cool21:26
mdkeso can I just grab the source of that and play with it? We're rolling out a new theme for help.u.c for intrepid I hope21:28
kirklandsure21:28
mdkealong these lines - http://doc.ubuntu.com/ubuntu/serverguide/C/index.html21:28
kirklandmdke: yeah, you can just look at the source of http://people.ubuntu.com/~kirkland/helpsearch.html21:28
kirklandmdke: everything you need is right in there21:29
kirklandmdke: one more thing...21:29
kirklandmdke: i just added "refinements"21:29
kirklandmdke: so search for something, like "Play a DVD"21:29
kirklandmdke: then you can filter your results21:29
mdkeyeah, that works really well21:30
kirklandmdke: to only "Official", "Community", or "Manuals"21:30
kirklandmdke: we can play with the text of those 3 areas21:30
kirklandmdke: but i think you'll get the idea21:30
mdkeI guess we should weigh per release as well, that search shows 7.04 a lot higher than 8.0421:30
kirklandmdke: that would be possible21:30
kirklandmdke: however, i'll warn you....21:30
kirklandmdke: i have had very little success improving Google's default weighting mechanisms21:31
kirklandmdke: i've tried a number of different things21:31
mdkeah, fair enough21:31
kirklandmdke: and always, I've found their weighting gets closer, more reliably21:31
mdkein that example, the 9th result should be 1st really. Is there any way to weight the official docs higher?21:31
kirklandmdke: sadly, it does mean that sometimes Dapper docs bubble to the top21:31
mdkeok21:31
kirklandmdke: because that Dapper doc is the most popular according to Goog21:32
kirklandmdke: yeah, you can assign weights to each21:32
mdkewhat have we got at the moment?21:32
kirklandmdke: equal weights, it's up to Google to sort the results21:34
mdkeso you think if we play with the weights, it won't help?21:35
kirklandmdke: let me adjust them21:36
kirklandmdke: but, I don't believe it'll help much ;-)21:36
kirklandone moment21:36
mdkei suppose ideally, the results would be sequential rather than mixed21:43
mdkeso official first, community, then manpages21:43
mdkebut I guess that isn't possible21:43
kirklandmdke: okay, so weights need to add up to 1.021:48
kirklandmdke: i gave Official=0.5, Community=0.3, Manuals=0.221:48
kirklandmdke: see if those results are any better for you21:48
mdkehmm. doesn't seem to be much different. "Play dvd" still gives a manpage as its second result21:49
mdkean irrelevant one too :(21:50
kirklandmdke: agreed, either i'm doing something wrong, or weighting is almost ineffectual21:50
kirklandmdke: i'm inclined to drop manpages from that list21:52
mdkeshall we try 0.6, 0.3 and 0.1 first?21:52
kirklandmdke: i'm using 0.9, 0.05, 0.05 right now :-)21:52
mdkeheh21:52
kirklandmdke: no effect21:52
kirklandmdke: i must be doing something wrong21:53
kirklandmdke: http://www.google.com/coop/docs/cse/cse_file.html21:53
mdkesame results here too21:53
kirklandmdke: #21:54
kirkland    *21:54
kirkland# weight: A number between -1 and 1, that indicates how much results annotated with that label should be demoted or promoted.21:54
mdkeah, perhaps we should go into the minuses21:54
kirklandmdke: yeah, let me play with that21:54
kirklandmdke: okay, now it's looking better21:59
kirklandmdke: i went with 1, 0, -122:00
mdkelooking good22:00
mdkei wonder how we should deal with the different versions on the official docs22:00
kirklandthat's tough...22:00
kirklandwe could use the same weighting22:01
kirkland(now that I've figured out what i've been doing wrong)22:01
mdkehmm22:01
mdkeit has to add up to 0?22:01
kirklandbut someone might actually want 7.04 for whatever reason22:01
kirklandmdke: no22:01
mdkehmm22:02
mdkenot sure how best to deal with those22:03
kirklandmdke: that's a tough one22:03
kirklandmdke: refinements?22:04
mdkehow hard would it be to have different weighting for the search bar on different parts of the site?22:05
kirklandmdke: you'd have to create a a separate CSE (custom search engine) for each distro22:05
kirklandmdke: not terribly hard to do, but your maintenance cost multiplies22:05
mdkeyeah22:06
kirklandmdke: search for "play a dvd 7.10"22:06
mdkemaybe we use refinements then22:06
kirklandand then for "play a dvd 8.04"22:07
kirklandwe just need to jam a version into the search terms itself22:07
mdkeyeah, that works nicely22:07
kirklandmdke: let me think on that22:08
kirklandmdke: search again, and you should see the link colours match our theme22:11
mdkecool22:13
kirklandmdke: basically, on the q=TERM we need to dynamically insert q=TERM+8.04 or whatever22:13
kirklandmdke: based on the place we are on the page22:13
kirklandmdke: on the "site", i mean22:13
mdkesounds tricky22:14
kirklandand it limits yours results22:14
kirklandmdke: refinements would be the way to go, IMHO22:14
* mdke nods22:14
kirklandmdke: do you prefer the words, intrepid, hardy, etc. or the versioned numbers?22:14
mdkeversions!!!22:14
mdkeheresy :)22:14
kirklandmdke: i like the words :-)22:15
mdkeme too, but they're not for users22:16
mdkeI'm just playing with the idea of whether it would be desirable to have our own search rather than google. It's those adverts that I think will annoy people22:19
kirklandmdke: yup22:19
kirklandmdke: i don't care either way22:19
kirklandmdke: see the ubuntu version refinements22:23
kirklandmdke: search http://people.ubuntu.com/~kirkland/helpsearch.html?cx=003883529982892832976%3Ae2vwumte3fq&cof=FORID%3A9&ie=UTF-8&q=play+a+dvd&sa=Search22:23
mdkekirkland: sorry, lost internet22:27
mdkeback now22:27
kirklandmdke: search http://people.ubuntu.com/~kirkland/helpsearch.html?cx=003883529982892832976%3Ae2vwumte3fq&cof=FORID%3A9&ie=UTF-8&q=play+a+dvd&sa=Search22:28
mdkehmm22:29
kirklandmdke: i can shoot a note to the list, if you'd like to gather feedback there?22:56
kirklandmdke: point to this demo page, etc?22:56

Generated by irclog2html.py 2.7 by Marius Gedminas - find it at mg.pov.lt!