721666 - TB: Keyboard Shortcuts documentation: Major Revision #5658: add lots of missing shortcuts (esp. for composition), regroup message functions, add subsection table headings, add article navigation and TOC

Status: RESOLVED FIXED

(Thunderbird :: Help Documentation, defect)

Description

[Thomas D. (:thomas8)]

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

This bug is intended for details and discussion of a major revision of the Keyboard Shortcuts documentation article (1) which I am about to land (and I want to link here from that revision's comment, so I need this bug first).
Please find the URL of that revision in the URL field or subsequent comments.

With this revision, after many hours if not days of work, I'll land a wide range of major improvements:

- add about 30 shortcuts that were missing (bug 716254), especially for, but not limited to composition
- major regrouping of shortcuts in "message functions" section
- add separate section for "Search and filter functions" (they are too important to be lost in the crowd)
- conflate "Newsgroup messages" section with only 3 newsgroup-specific commands into "Message functions" section (the old structure was logically misleading because all message functions also apply to newsgroup messages)
- add subsection table headings to all sections, group logically related functions (for meaningful and human-friendly navigation instead of endless one-for-all lists lacking recognizable structure - after all, this is a HELP document!)
- add linkified TOC to this article (to allow fast-track navigation)
- add linkified TOC for list of shortcuts (main section headings)
- add links for quick navigation within shortcuts list, including inter-section cross-references
- improve some command captions
- fix/remove wrong/outdated keyboard shortcuts (done)

I'll add the bugs which I have improved or fixed with this revision as dependants of this bug (unless specified otherwise in subsequent comments). In very few cases, fixes and improvements might be preliminary or incomplete because I cannot verify shortcuts on Linux and MAC. I have filed respective bugs which are awaiting verification.

This revision is a major milestone as it concludes a series of major revisions to reconvert "Keyboards Shortcuts" into a useful document that keeps the promise with complete, accurate, and accessible information. Still, it may not be the end of the road (and nobody/nothing is perfect). For further refinements, pls refer to tbkbd-doc-tracker Bug 714031 and tbkbd-docnew-tracker Bug 714044. And please help to keep it up-to-date, by adding anything of relevance to tb-keyboard-tracker bug 713979 and tbkbd-doc-tracker Bug 714031.

Any hints or comments regarding this revision are welcome here.

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

Comment 1

[Thomas D. (:thomas8)]

(In reply to Thomas D. from comment #0)
> This bug is intended for details and discussion of a major revision of the
> Keyboard Shortcuts documentation article (1) which I am about to land (and I
> want to link here from that revision's comment, so I need this bug first).
> Please find the URL of that revision in the URL field or subsequent comments.

This bug is about
https://support.mozillamessaging.com/en-US/kb/keyboard-shortcuts/revision/5658
(and not about revision 5614, which was an artefact of cloning)

Comment 2

[Thomas D. (:thomas8)]

A lot of bugs were fixed by this major revision (see dependants). Some shortcut keys still need explicit verification for MAC/Linux; for very few of these problem case, I've just kept what was already there; otherwise, I have excluded a few of them  (like (Advanced) Search shortcuts in AB) or assumed the traditional defaults (MAC Command vs. Win/Linux Ctrl etc.) to ensure as much completeness and correctness as possible.