716270 - TB: Add better link for direct downloading of keyconfig Addon to Keyboard Shortcuts documentation

Status: RESOLVED FIXED

(Thunderbird :: Help Documentation, defect)

Description

[Thomas D. (:thomas8)]

+++ This bug was initially created as a clone of Bug #716222 +++

Current Documentation:

Thunderbird Keyboard Shortcuts documentation (1) currently has this:

==Customizing keyboard shortcuts==
The _Keyconfig extension_ allows you to configure keyboard shortcuts. (Note that third-party extensions are not supported or endorsed by Mozilla.) 

STR

1) Try following the link to find the actual download for keyconfig extension

Actual result:

We are sending the user on a long and confusing odyssey in search for an actual download of the keyconfig addon:

_Keyconfig extension_ link from our shortcuts documentation points to
1) http://kb.mozillazine.org/Keyconfig_extension%3A_Thunderbird

On that page, there is still no download link for the extension, but a confusing link at the top, which wrongly points back to the mozillazine article itself:
> For example, see: _Keyconfig extension_
2) http://kb.mozillazine.org/Keyconfig_extension%3A_Thunderbird

User needs to parse the whole article or at least a long TOC to find anything which might link to the actual extension (if he is lucky):
> 7 _External links_ (from TOC, points to bottom of page)
3) http://kb.mozillazine.org/Keyconfig_extension%3A_Thunderbird#External_links

Under "External links", we'll find
> _KeyConfig thread_ in Extension/Theme releases forum 
which then points to:
4) http://forums.mozillazine.org/viewtopic.php?f=48&t=72994

And there, finally, hidden inconspicously in the first post:
> _keyconfig_ allows you to change keyboard shortcuts. [Firefox, Thunderbird,
> SeaMonkey, and any other XULRunner Application]
now pointing to the *actual* download:
5) http://mozilla.dorando.at/keyconfig.xpi

That's 5 links before getting what I actually want, and what was promised on our page. 4 too many.

Expected Result:

Add a direct download link for the extension, like this:

The _Keyconfig extension_ (*_download here_*) allows you to configure keyboard shortcuts. (Note that third-party extensions are not supported or endorsed by Mozilla.) 

..., where:

_Keyconfig extension_ still links to
1) http://kb.mozillazine.org/Keyconfig_extension%3A_Thunderbird
(thus providing access to all the valuable resources of information mentioned above), but

_download here_ links directly to 
5) http://mozilla.dorando.at/keyconfig.xpi

(1) https://support.mozillamessaging.com/en-US/kb/keyboard-shortcuts

Comment 1

[Thomas D. (:thomas8)]

The problem with just adding the direct download link [http://mozilla.dorando.at/keyconfig.xpi] is that it will trigger a Firefox installation of that addon. Which isn't helpful for TB users.

Comment 2

[Thomas D. (:thomas8)]

I fixed this in major revision 5658 (1), as documented in bug 721666.

(In reply to Thomas D. from comment #1)
> The problem with just adding the direct download link
> [http://mozilla.dorando.at/keyconfig.xpi] is that it will trigger a Firefox
> installation of that addon. Which isn't helpful for TB users.

I worked around this problem by adding a "right-click"-hint with the direct download link:

The [http://kb.mozillazine.org/Keyconfig_extension%3A_Thunderbird Keyconfig addon] (right-click [http://mozilla.dorando.at/keyconfig.xpi here] to download) allows you to configure keyboard shortcuts. (Note that third-party addons are not supported or endorsed by Mozilla.)

Which will be rendered as:

The Keyconfig addon (right-click _here_ to download) allows you to configure keyboard shortcuts. (Note that third-party addons are not supported or endorsed by Mozilla.)

Comment 3

[Thomas D. (:thomas8)]

(In reply to Thomas D. from comment #2)
> I fixed this in major revision 5658 (1), as documented in bug 721666.

(1) https://support.mozillamessaging.com/en-US/kb/keyboard-shortcuts/revision/5658