1095476 - Showfor controls are hard to find.

Status: RESOLVED FIXED

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

Description

[Lars Viklund]

User Agent: Mozilla/5.0 (X11; Linux x86_64; rv:33.0) Gecko/20100101 Firefox/33.0
Build ID: 20141015093046

Steps to reproduce:

I want to on a secondary machine, find information (via deep link from other KB) on how to change from Outlook to Thunderbird on the primary machine.

Steps:
On a Linux machine, navigate to https://support.mozilla.org/en-US/kb/switching-thunderbird#w_switching-from-outlook-2007-to-thunderbird

Look for the section on changing from any Windows-based mail client to Thunderbird.


Actual results:

Only sections of the page relevant to the host OS (Linux) are shown, with JavaScript removing all sections that are not.

Only obvious and bad way around is completely disabling JavaScript via NoScript.


Expected results:

The assumption that the OS the user navigates with is the OS the user wants information for appears to be a flawed one. People have multiple devices with different OSes for different tasks.

There appears to be no way to tell that a filter has happened (apart from a flash of unfiltered content), and there is no way to inhibit the filter as a mortal user.

Comment 1

[Michael Cooper [:mythmon]]

The targeted platform can be changed with the "Customize this article" controls in the Editing Tools of the page. They are hidden by default, and have to be expanded by clicking on the "Editing Tools" item in the left sidebar. This isn't the most intuitive UI, but it is certainly attainable for a "mortal user".

If you don't mind, I've changed the summary of this bug to reflect that the UI is unintuitive, instead of something being impossible with Thunderbird articles.

Thanks a lot for the bug report!

Comment 2

[jscher2000]

A suggested quick fix, since users sometimes complain on SuMo about getting the wrong platform instructions. We just need "Customize This Article" -- if include_showfor is true -- to appear regardless of whether EDITING TOOLS is expanded or collapsed.

In this file:

https://github.com/mozilla/kitsune/blob/master/kitsune/wiki/jinja2/wiki/includes/sidebar_modules.html

Move lines:

55          {% if include_showfor %}
56            <li>
57              {{ show_for((document or parent).get_products(), header=False) }}
58            </li>
59          {% endif %}

between lines 8 and 9:

07  <nav id="doc-tools">
08    <ul class="sidebar-nav sidebar-folding">

09      <li id="editing-tools-sidebar" {% if active != 'article' %} class="selected"{% endif %}>
10        <span>{{ _('Editing Tools') }}</span>

That position would maximize discoverability vs. placing it below EDITING TOOLS, between lines 61 and 62.

60        </ul>
61      </li>

62    </ul>

Comment 3

[Wayne Mery (:wsmwk)]

So this moves it outside editing tools?  
If so, I think that would be sufficient.

Comment 4

[jscher2000]

What would it take to make this happen? Does it need to be filed as an Issue on

https://github.com/mozilla/kitsune/issues

Comment 5

[Roland Tanglao needinfo please :rolandtanglao, :mohnkuchen, :adobo, :sinigang, :roland]

:giorgos is a github issue the way to move this bug forward?

Comment 6

[Giorgos Logiotatidis [:giorgos]]

(In reply to Roland Tanglao needinfo please :rolandtanglao, :mohnkuchen, :adobo, :sinigang, :roland from comment #5)
> :giorgos is a github issue the way to move this bug forward?

No that wouldn't help now. If somebody wants to submit a PR we can review. Otherwise we'll come to bugzilla bugs eventually.

Comment 7

[Alice Wyman]

Related discussion:
https://support.mozilla.org/en-US/forums/contributors/713102

Comment 8

[Alice Wyman]

See also bug 1527337 comment 5 2019-02-14 02:09 EST (quote) An average reader, not intending to edit a knowledge base, would not think to use an editing menu to discover the incompleteness of a document. Not good UX.

Comment 9

[Graham Perrin]

(In reply to Wayne Mery (:wsmwk) from comment #3)

So this moves it outside editing tools?
If so, I think that would be sufficient.

Not just Customize this article. Other things are misplaced; https://support.mozilla.org/forums/contributors/713102#post-75490 mentions History … and so on.

Take the perspective of a reader. Not logged in (NLI), or not knowing whether they're logged in.

I'll actively avoid anything that might interrupt my train of thought – these things include registration, e-mail address confirmation and so on; the last thing I'm gonna click is a thing that might trigger that process, and Editing tools falls under this umbrella.

Comment 10

[Alice Wyman]

The Customize this article showfor controls for KB articles are now separate from Editing tools, as shown here for Thunderbird,
https://support.mozilla.org/en-US/kb/switching-thunderbird and here for Firefox:
https://support.mozilla.org/en-US/kb/update-firefox-latest-release
Users are now able to customize content, such as version and operating system, even when not logged in to SUMO. Resolve this bug as fixed?