Merge branch 'docs-shortcut-page-update' into 'master'

Shortcut page cleanup

See merge request gitlab-org/gitlab!56024

doc/user/shortcuts.md

@@ -6,25 +6,32 @@ type: reference
 disqus_identifier: 'https://docs.gitlab.com/ee/workflow/shortcuts.html'
 ---
 
-# GitLab keyboard shortcuts
+# GitLab keyboard shortcuts **(FREE)**
+
+GitLab has several keyboard shortcuts you can use to access its different
+features.
+
+To display a window in GitLab that lists its keyboard shortcuts, use one of the
+following methods:
+
+- Press <kbd>?</kbd>.
+- In the Help menu in the top right of the appication, select **Keyboard shortcuts**.
 
-GitLab has many useful keyboard shortcuts to make it easier to access different features.
-You can see a modal listing keyboard shortcuts within GitLab itself by pressing <kbd>?</kbd>,
-or clicking **Keyboard shortcuts** in the Help menu at the top right.
 In [GitLab 12.8 and later](https://gitlab.com/gitlab-org/gitlab/-/issues/22113),
-keyboard shortcuts can be disabled using the **Enable**/**Disable** toggle in this modal window.
+you can disable keyboard shortcuts by using the **Keyboard shortcuts** toggle
+at the top of the keyboard shortcut window.
 
-The [Global Shortcuts](#global-shortcuts) work from any area of GitLab, but you must
-be in specific pages for the other shortcuts to be available, as explained in each
-section below.
+Although [global shortcuts](#global-shortcuts) work from any area of GitLab,
+you must be in specific pages for the other shortcuts to be available, as
+explained in each section.
 
-## Global Shortcuts
+## Global shortcuts
 
-These shortcuts are available in most areas of GitLab
+These shortcuts are available in most areas of GitLab:
 
-| Keyboard Shortcut               | Description |
-| ------------------------------- | ----------- |
-| <kbd>?</kbd>                    | Show/hide shortcut reference sheet. |
+| Keyboard shortcut               | Description |
+|---------------------------------|-------------|
+| <kbd>?</kbd>                    | Show or hide the shortcut reference sheet. |
 | <kbd>Shift</kbd> + <kbd>p</kbd> | Go to your Projects page. |
 | <kbd>Shift</kbd> + <kbd>g</kbd> | Go to your Groups page. |
 | <kbd>Shift</kbd> + <kbd>a</kbd> | Go to your Activity page. |
@@ -34,41 +41,41 @@ These shortcuts are available in most areas of GitLab
 | <kbd>Shift</kbd> + <kbd>i</kbd> | Go to your Issues page. |
 | <kbd>Shift</kbd> + <kbd>m</kbd> | Go to your Merge requests page.|
 | <kbd>Shift</kbd> + <kbd>t</kbd> | Go to your To-Do List page. |
-| <kbd>p</kbd> + <kbd>b</kbd>     | Show/hide the Performance Bar. |
+| <kbd>p</kbd> + <kbd>b</kbd>     | Show or hide the Performance Bar. |
 | <kbd>g</kbd> + <kbd>x</kbd>     | Toggle between [GitLab](https://gitlab.com/) and [GitLab Next](https://next.gitlab.com/) (GitLab SaaS only). |
 
-Additionally, the following shortcuts are available when editing text in text fields,
-for example comments, replies, issue descriptions, and merge request descriptions:
+Additionally, the following shortcuts are available when editing text in text
+fields (for example, comments, replies, issue descriptions, and merge request
+descriptions):
 
-| Keyboard Shortcut                                                      | Description |
-| ---------------------------------------------------------------------- | ----------- |
-| <kbd>↑</kbd>                                                           | Edit your last comment. You must be in a blank text field below a thread, and you must already have at least one comment in the thread. |
-| <kbd>⌘</kbd> (Mac) / <kbd>Control</kbd> + <kbd>Shift</kbd> + <kbd>p</kbd> | Toggle Markdown preview, when editing text in a text field that has **Write** and **Preview** tabs at the top. |
+| Keyboard shortcut                                                         | Description |
+|---------------------------------------------------------------------------|-------------|
+| <kbd>↑</kbd>                                                              | Edit your last comment. You must be in a blank text field below a thread, and you must already have at least one comment in the thread. |
+| <kbd>⌘</kbd> (Mac) / <kbd>Control</kbd> + <kbd>Shift</kbd> + <kbd>p</kbd> | Toggle Markdown preview when editing text in a text field that has **Write** and **Preview** tabs at the top. |
 | <kbd>⌘</kbd> (Mac) / <kbd>Control</kbd> + <kbd>b</kbd>                    | Bold the selected text (surround it with `**`). |
 | <kbd>⌘</kbd> (Mac) / <kbd>Control</kbd> + <kbd>i</kbd>                    | Italicize the selected text (surround it with `_`). |
 | <kbd>⌘</kbd> (Mac) / <kbd>Control</kbd> + <kbd>k</kbd>                    | Add a link (surround the selected text with `[]()`). |
 
-NOTE:
-The shortcuts for editing in text fields are always enabled, even when
-other keyboard shortcuts are disabled as explained above.
+The shortcuts for editing in text fields are always enabled, even if other
+keyboard shortcuts are disabled.
 
 ## Project
 
-These shortcuts are available from any page within a project. You must type them
+These shortcuts are available from any page in a project. You must type them
 relatively quickly to work, and they take you to another page in the project.
 
-| Keyboard Shortcut           | Description |
-| --------------------------- | ----------- |
+| Keyboard shortcut           | Description |
+|-----------------------------|-------------|
 | <kbd>g</kbd> + <kbd>p</kbd> | Go to the project home page (**Project > Details**). |
 | <kbd>g</kbd> + <kbd>v</kbd> | Go to the project activity feed (**Project > Activity**). |
 | <kbd>g</kbd> + <kbd>r</kbd> | Go to the project releases list (**Project > Releases**). |
 | <kbd>g</kbd> + <kbd>f</kbd> | Go to the [project files](#project-files) list (**Repository > Files**). |
-| <kbd>t</kbd>                | Go to the project file search page. (**Repository > Files**, click **Find Files**). |
+| <kbd>t</kbd>                | Go to the project file search page. (**Repository > Files**, select **Find Files**). |
 | <kbd>g</kbd> + <kbd>c</kbd> | Go to the project commits list (**Repository > Commits**). |
 | <kbd>g</kbd> + <kbd>n</kbd> | Go to the [repository graph](#repository-graph) page (**Repository > Graph**). |
 | <kbd>g</kbd> + <kbd>d</kbd> | Go to repository charts (**Analytics > Repository Analytics**). |
 | <kbd>g</kbd> + <kbd>i</kbd> | Go to the project issues list (**Issues > List**). |
-| <kbd>i</kbd>                | Go to the New Issue page (**Issues**, click **New Issue** ). |
+| <kbd>i</kbd>                | Go to the New Issue page (**Issues**, select **New Issue** ). |
 | <kbd>g</kbd> + <kbd>b</kbd> | Go to the project issue boards list (**Issues > Boards**). |
 | <kbd>g</kbd> + <kbd>m</kbd> | Go to the project merge requests list (**Merge Requests**). |
 | <kbd>g</kbd> + <kbd>j</kbd> | Go to the CI/CD jobs list (**CI/CD > Jobs**). |
@@ -78,52 +85,52 @@ relatively quickly to work, and they take you to another page in the project.
 | <kbd>g</kbd> + <kbd>s</kbd> | Go to the project snippets list (**Snippets**). |
 | <kbd>g</kbd> + <kbd>w</kbd> | Go to the project wiki (**Wiki**), if enabled. |
 
-### Issues and Merge Requests
+### Issues and merge requests
 
-These shortcuts are available when viewing issues and merge requests.
+These shortcuts are available when viewing issues and merge requests:
 
-| Keyboard Shortcut            | Description |
-| ---------------------------- | ----------- |
+| Keyboard shortcut            | Description |
+|------------------------------|-------------|
 | <kbd>e</kbd>                 | Edit description. |
 | <kbd>a</kbd>                 | Change assignee. |
 | <kbd>m</kbd>                 | Change milestone. |
 | <kbd>l</kbd>                 | Change label. |
-| <kbd>r</kbd>                 | Start writing a comment. If any text is selected, it is quoted in the comment. Can't be used to reply within a thread. |
+| <kbd>r</kbd>                 | Start writing a comment. Pre-selected text is quoted in the comment. Can't be used to reply in a thread. |
 | <kbd>n</kbd>                 | Move to next unresolved discussion (merge requests only). |
 | <kbd>p</kbd>                 | Move to previous unresolved discussion (merge requests only). |
 | <kbd>]</kbd> or <kbd>j</kbd> | Move to next file (merge requests only). |
 | <kbd>[</kbd> or <kbd>k</kbd> | Move to previous file (merge requests only). |
 | <kbd>b</kbd>                 | Copy source branch name (merge requests only). |
 
-### Project Files
+### Project files
 
-These shortcuts are available when browsing the files in a project (navigate to
-**Repository** > **Files**):
+These shortcuts are available when browsing the files in a project (go to
+**Repository > Files**):
 
-| Keyboard Shortcut | Description |
-| ----------------- | ----------- |
+| Keyboard shortcut | Description |
+|-------------------|-------------|
 | <kbd>↑</kbd>      | Move selection up. |
 | <kbd>↓</kbd>      | Move selection down. |
 | <kbd>enter</kbd>  | Open selection. |
-| <kbd>Escape</kbd>    | Go back to file list screen (only while searching for files, **Repository > Files** then click on **Find File**). |
+| <kbd>Escape</kbd> | Go back to file list screen (only while searching for files, **Repository > Files**, then select **Find File**). |
 | <kbd>y</kbd>      | Go to file permalink (only while viewing a file). |
 
 ### Web IDE
 
 These shortcuts are available when editing a file with the [Web IDE](project/web_ide/index.md):
 
-| Keyboard Shortcut                                       | Description |
-| ------------------------------------------------------- | ----------- |
+| Keyboard shortcut                                          | Description |
+|------------------------------------------------------------|-------------|
 | <kbd>⌘</kbd> (Mac) / <kbd>Control</kbd> + <kbd>p</kbd>     | Search for, and then open another file for editing. |
 | <kbd>⌘</kbd> (Mac) / <kbd>Control</kbd> + <kbd>Enter</kbd> | Commit (when editing the commit message). |
 
-### Repository Graph
+### Repository graph
 
 These shortcuts are available when viewing the project [repository graph](project/repository/index.md#repository-graph)
 page (navigate to **Repository > Graph**):
 
-| Keyboard Shortcut                                                  | Description |
-| ------------------------------------------------------------------ | ----------- |
+| Keyboard shortcut                                                  | Description |
+|--------------------------------------------------------------------|-------------|
 | <kbd>←</kbd> or <kbd>h</kbd>                                       | Scroll left. |
 | <kbd>→</kbd> or <kbd>l</kbd>                                       | Scroll right. |
 | <kbd>↑</kbd> or <kbd>k</kbd>                                       | Scroll up. |
@@ -135,25 +142,25 @@ page (navigate to **Repository > Graph**):
 
 This shortcut is available when viewing a [wiki page](project/wiki/index.md):
 
-| Keyboard Shortcut | Description |
-| ----------------- | ----------- |
+| Keyboard shortcut | Description |
+|-------------------|-------------|
 | <kbd>e</kbd>      | Edit wiki page. |
 
-### Filtered Search
+### Filtered search
 
 These shortcuts are available when using a [filtered search input](search/index.md):
 
-| Keyboard Shortcut                                     | Description |
-| ----------------------------------------------------- | ----------- |
-| <kbd>⌘</kbd> (Mac) + <kbd>⌫</kbd>                     | Clear entire search filter. |
-| <kbd>⌥</kbd> (Mac) / <kbd>Control</kbd> + <kbd>⌫</kbd>   | Clear one token at a time. |
+| Keyboard shortcut                                      | Description |
+|--------------------------------------------------------|-------------|
+| <kbd>⌘</kbd> (Mac) + <kbd>⌫</kbd>                      | Clear entire search filter. |
+| <kbd>⌥</kbd> (Mac) / <kbd>Control</kbd> + <kbd>⌫</kbd> | Clear one token at a time. |
 
 ## Epics **(ULTIMATE)**
 
-These shortcuts are available when viewing [Epics](group/epics/index.md):
+These shortcuts are available when viewing [epics](group/epics/index.md):
 
-| Keyboard Shortcut | Description |
-| ----------------- | ----------- |
-| <kbd>r</kbd>      | Start writing a comment. If any text is selected, it is quoted in the comment. Can't be used to reply within a thread. |
+| Keyboard shortcut | Description |
+|-------------------|-------------|
+| <kbd>r</kbd>      | Start writing a comment. Pre-selected text is quoted in the comment. Can't be used to reply in a thread. |
 | <kbd>e</kbd>      | Edit description. |
 | <kbd>l</kbd>      | Change label. |