Searching on doesn't produce results from

Bug #1310309 reported by Christopher M. Penalver on 2014-04-20
This bug affects 2 people
Affects Status Importance Assigned to Milestone
Online publishing of the Ubuntu documentation

Bug Description

What is expected to happen is when one goes to:

and searches for example Debugging, one of the results would be:

However, no results from are listed under any of the default categories (All Results, Official, Community, Technical, AskUbuntu). One would have to know upfront from trial and error/experience that in order to get results from one has to go to there and then look it up.

While I am aware of the different articles that I typically look for, and on which page to search for them, I constantly find myself desiring to be able to do a one stop shop search, instead of flipping between the two. Given this, having this searching capability would certainly empower the Ubuntu Community in their efforts to search for relevant documentation.

One potential resolution would be to integrate the results from into Official, as the articles there tend to be released from Ubuntu/Canonical developers, and are of high technical quality.

If this would not be preferred, another solution would be to create a new search category (ex. Ubuntu Wiki), that populates results from only.

Gunnar Hjalmarsson (gunnarhj) wrote :

Hi Christopher,

While I don't know why is not included in the results generated by that search feature, I have a theory. is principally intended for individuals and teams, i.e. not user documentation. So there is a risk that including would lead to quite a few irrelevant items being included in the search results.

Possibly it would be better to move docs pages in to But I have certainly no firm opinion.

Gunnar Hjalmarsson, thanks for the response.
>"I have a theory. is principally intended for individuals and teams, i.e. not user documentation."

The vast majority of developer and end-user debugging documentation from all the developer teams are in (ex. ).

>"So there is a risk that including would lead to quite a few irrelevant items being included in the search results."

The current issue is that for many search terms, most or all of what results from is either irrelevant, or lower quality results (ex. AskUbuntu PPAs/WORKAROUNDs/hacks, etc.), in comparison to

As well, the small negative of including results from that wouldn't apply, is outweighed by far from the increase in relevant results from the same.

For example, if one searches for pepper, intending to find the highest quality information about Pepper Flash (i.e. no PPA, WORKAROUNDs, etc.) in one only finds not relevant, and lower quality information in the AskUbuntu category.

However, if one does a full text search at one would find the most relevant article:

This outcome is largely reproducible across various search terms.

Doug Smythies (dsmythies) wrote :

It is true that is not included. You can observe a list of what is at:

Where, we can see that it needs to be updated because it is still pointing to

I have been searching in old doc-list e-mails, but didn't yet find anything relevant as to the reasons behind this stuff.

The problem is that nobody is still involved with docs that knows about this. Myself, I do not know how to update the google custom search thing.

Doug Smythies (dsmythies) wrote :

The CSE has been updated.

Christopher: Try your example now. It was first in the list for me.

The questions remains if we want to keep this change or if it will result in a lot of garbage information. We have been asked to test this over the next few days.

Doug Smythies, thanks for the update.

Searching for debugging gives a lot of highly relevant results from, with the expected DebuggingProcedures page at the top of the list.

As well, searching for pepper gives the expected pepper flash plugin install article at the top of the list.

As far as I'm concerned, the searching has been dramatically improved for the betterment of the Ubuntu Community.

Dustin Kirkland  (kirkland) wrote :

Thanks Doug, Gunnar, for emailing me. I'm now subscribed to this bug. I created this CSE some years ago, along with Matthew East, and have maintained it.

I've made a couple of the changes requested here in this bug, namely adding the "stable" and "lts" official docs.

I also added, somewhat reluctantly, however. We removed it from the search some years ago, as the wiki is not really "official" or "curated" documentation. It's a little messy, disorganized, and contains a ton of out of date information. It turns up hits, such as (ancient) IRC meeting logs, which is clearly not what a user searching wants.

In any case, it's enabled at this point, for at least a little bit of testing.

I'll be working with Doug and Gunnar in the future, who have expressed an interest in helping co-maintain the CSE.


Doug Smythies (dsmythies) wrote :

@Dustin: On our e-mail thread you had asked that we review the inclusion of in "a few days". We would like to push a review out about 2 months. Would that be O.K. with you?

Due to issues with the .htaccess file and the the robots.txt file and the CSE needing an update, we think people have not been using the built in search. We want to try to get a broader audience using it again and get opinions.

affects: ubuntu-docs (Ubuntu) →

I'm classifying as Fix Released, given the issue in the Bug Description (searching for debugging shows wiki.ubuntu results) is now resolved.

Changed in
status: Triaged → Fix Released
To post a comment you must log in.
This report contains Public information  Edit
Everyone can see this information.

Other bug subscribers