674920 - [tracker] Reorganize "Relevant To" products

Status: VERIFIED FIXED

(support.mozilla.org :: Knowledge Base Software, task)

Description

[James Socol [:jsocol, :james]]

Attachment: An unsustainable model

After discussion in email and at a sumodev meeting, I think we're agreed that Relevant To (see attachment) isn't sustainable as-is, and that it should be re-focused on products.

NB: These changes *would NOT affect* showfor--they would dissociate showfor from Relevant-to.

Given that OS-specific articles are very rarely used, and the few that exist are clearly annotated in the articles themselves, I think it makes sense to remove/combine both sections and replace them with a list of products, i.e.:

Relevant To:
[]Firefox on Desktops
[]Firefox on Mobile
[]Firefox Sync
[]Firefox Home
[]Thunderbird (maybe, in the future?)

Showfor would then be used to breakdown content within the articles.

I have no technical notes yet on how to make the transition. Ideas are welcome.

Comment 1

[Scoobidiver (away)]

(In reply to comment #0)
> []Firefox on Desktops
> []Firefox on Mobile
> []Firefox Sync
> []Firefox Home
There are already mobile, sync and fxhome flags in topics.
A desktop flag can also be created. The problem will be with displayed related articles: troubleshooting and how-to articles are numerous on desktop.

> Given that OS-specific articles are very rarely used, and the few that exist
> are clearly annotated in the articles themselves
They are not all annotated:
* https://support.mozilla.com/en-US/kb/Importing%20Internet%20Explorer%20Favorites%20from%20another%20computer
* https://support.mozilla.com/en-US/kb/Exporting%20data%20to%20Internet%20Explorer
* https://support.mozilla.com/en-US/kb/Configuring%20Windows%20Firewall
* https://support.mozilla.com/en-US/kb/Configuring%20Norton%20360
But it's easy to add an annotation.

Comment 2

[James Socol [:jsocol, :james]]

(In reply to comment #1)
> The problem will be with displayed
> related articles: troubleshooting and how-to articles are numerous on
> desktop.

That's a really good reason not to do this with tags.

But, let's hold off on doing anything with this right now, until we get more input from the UX research going on.

Comment 3

[James Socol [:jsocol, :james]]

(In reply to comment #2)
> That's a really good reason not to do this with tags.

s/really good //.

Talked to Crystal, Kadir and Michael: we should go ahead with this reorganization.

On the back-end, we're OK dropping the current ManyToManyFields with tags/topics. The check boxes in the UI should just add or remove the relevant topic for each product. (A little more complicated UI, a lot less complicated back end.)

Proposed topics for this:

"desktop"
"mobile"
"sync"
"home" (or possibly "fxhome"?)

This also means we can easily add new products in the future.

Comment 4

[Scoobidiver (away)]

(In reply to comment #3)
> The check boxes in the UI should just add or remove the relevant topic for
> each product.
Will these checkboxes be associated to a product or a search category?
Because all Sync articles and some mobile articles must be searchable from the desktop product.
Indeed, Sync is a built-in feature and some mobile articles will only be searched from the desktop product:
* https://support.mozilla.com/en-US/kb/will-firefox-work-my-mobile-device (mobile topic but all OSes)
* https://support.mozilla.com/en-US/kb/install-firefox-mobile (mobile topic but all OSes)
* https://support.mozilla.com/en-US/kb/sync-firefox-between-desktop-and-mobile ((mobile topic but all OSes - three search categories for this one)

> This also means we can easily add new products in the future.
SeaMonkey? http://www.seamonkey-project.org/

Comment 5

[James Socol [:jsocol, :james]]

(In reply to comment #4)
> some mobile articles

That is exactly the point of this feature.

> Indeed, Sync is a built-in feature and some mobile articles will only be
> searched from the desktop product:

We'll replace the current method of filtering searches on the home page (which relies on the current relevant-to section) with filtering by tag. If the default search on the desktop support home page should include sync, it will.

> > This also means we can easily add new products in the future.
> SeaMonkey? http://www.seamonkey-project.org/

Maybe, or Thunderbird, or other Services like BrowserID or Web Apps or...

Comment 6

[James Socol [:jsocol, :james]]

We all agree, let's make this happen. Tasks:

* Change the UI in the document adding/editing to what's described in comment 3.
* Add a 'desktop' tag to all articles that are currently "relevant to" a desktop OS or FX version.
* Change the showfor JS to set the relevant tag, instead of OS/Fx combo, on search boxes.
* Fix the KB search indexer.
* Change the search UI (make it similar to the UI for adding/editing).
* Change the search filter assignments.
* Drop the old models and any remaining references to them.
* Drop the old tables. (Preferably in the next release so we can avoid stack traces.)

...maybe this should be a tracker.

Did I miss anything?

Comment 7

[Ricky Rosario [:rrosario, :r1cky]]

all blockers fixed \0/

Comment 8

[Tobias (:Tobbi) Markus]

Verification will be done on the individual blockers. Marking this bug as verified to get them off the list.