gnome-user-docs issueshttps://gitlab.gnome.org/GNOME/gnome-user-docs/-/issues2024-03-10T11:58:05Zhttps://gitlab.gnome.org/GNOME/gnome-user-docs/-/issues/143Update top bar icons2024-03-10T11:58:05ZShaun McCanceUpdate top bar iconsThe style of top bar icons in adwaita-icon-theme changed a bit. Redo them in gnome-help.The style of top bar icons in adwaita-icon-theme changed a bit. Redo them in gnome-help.GNOME 45https://gitlab.gnome.org/GNOME/gnome-user-docs/-/issues/187Touch Gestures Inconsistency and Incorrect Documentation2023-10-08T08:19:40ZD BTouch Gestures Inconsistency and Incorrect DocumentationI have recently been experimenting with Linux on convertible tablets to replace my Chromebook, and after some distro-hopping found Fedora Gnome to be the best for screen rotation, trackpad, and touchscreen support. However, I am constant...I have recently been experimenting with Linux on convertible tablets to replace my Chromebook, and after some distro-hopping found Fedora Gnome to be the best for screen rotation, trackpad, and touchscreen support. However, I am constantly frustrated with the inconsistency between gestures on trackpad vs. touchscreen.
In my quest for a solution to this inconsistency I have found zero solutions and 3 separate pages on [gnome.org](http://gnome.org) which give differing information about gestures. The help.gnome.org page had a link to email feedback to docs-feedback@gnome.org but I received an automatic "rejected" response:
> Unfortunately, your email message to GitLab could not be processed.
>
> We couldn't figure out what the email is for. Please create your issue or comment through the web interface.
My feedback is as follows:
https://infrastructure.pages.gitlab.gnome.org/help.gnome.org//gnome-help/touchscreen-gestures.html
- 1st and 2nd system-wide gestures state 3 fingers for Activities Overview and Workspace switching; correct for trackpad, touchscreen requires 4 fingers
- 1st application gesture (tap) only selects items on both trackpad and touchscreen, does not open files; does activate buttons such as playing music or launching programs
- 2nd application gesture (press and hold) works on touchscreen, does nothing on trackpad
https://help.gnome.org/users/gnome-help/stable/touchscreen-gestures.html.en
- System-wide gestures
- 1st gesture does not work on trackpad or touchscreen
- 2nd, 3rd, and 4th gestures only work by happenstance; they actually activate whichever item in the top bar your finger is on when leaving the screen, not always the stated menu; on trackpad they, as expected, simply move the mouse
- 6th gesture does not work on trackpad, only on touchscreen
- 7th gesture opens Activities Overview on touchscreen, does nothing on trackpad; switching Workspaces on touchscreen actually requires a sideways 4-finger swipe, not up or down.
- Application gestures
- 1st gesture (tap) only selects items on both trackpad and touchscreen, does not open files; does activate buttons such as playing music or launching programs
- 2nd and 3rd gestures do nothing on trackpad, works on touchscreen
https://wiki.gnome.org/Design/OS/Gestures
- 1st gesture (tap) only selects items on both trackpad and touchscreen, does not open files; does activate buttons such as playing music or launching programs
- 2nd and 3rd gestures do nothing on trackpad, works on touchscreen
- 5th gesture (double-tap)
- Selects text in browsers and documents for both trackpad and touchscreen
- Launch files, open folders, etc., on both trackpad and touchscreen
- Toggles fullscreen in ImageViewer on trackpad and does nothing on touchscreen
- 7th gesture (edge drag) are functional identical to my feedback for the 2nd, 3rd, and 4th gestures on the help.gnome.org link above, plus the final variation "left edge" does nothing at all on touchscreen; on trackpad they, as expected, simply move the mouse
- 8th gesture (3-finger pinch) does nothing on trackpad or touchscreen
- 9th gesture (4-finger drag) does nothing on trackpad, on touchscreen it opens the Activities Overview (up) or switches Workspace (left and right)
- 10th gesture (3-finger hold + tap) does not work on trackpad, only on touchscreen
- Further, under the list with icons is a table titled "Touchpad Specifics" which, while highlighting the odd 3-to-4 finger discrepancy, inaccurately states up and down gestures on touchscreen switch Workspaces; on my devices, up opens the Activities Overview while left and right switch Workspaces
Please can you amend the documentation to correctly reflect how gestures work within Gnome?
[I have asked in the Gnome forums](https://discourse.gnome.org/t/touch-gestures-inconsistency/17517) about how to actually change touchscreen 4-finger gestures to match the 3 fingers used on trackpads. If no solution is presented I may raise a separate Gitlab issue asking for this inconsistency to be fixed.https://gitlab.gnome.org/GNOME/gnome-user-docs/-/issues/166Update net-mobile.page (Mobile Broadband) for Quick Settings in GNOME 432023-07-25T09:17:36ZAndre KlapperUpdate net-mobile.page (Mobile Broadband) for Quick Settings in GNOME 43`The <gui>Mobile Broadband</gui> section of the menu will expand.` is likely not valid anymore. Cannot test because that machine has no SIM card hardware slot. Also remove the `<gui>` markup here for consistency, per #133.
See https://g...`The <gui>Mobile Broadband</gui> section of the menu will expand.` is likely not valid anymore. Cannot test because that machine has no SIM card hardware slot. Also remove the `<gui>` markup here for consistency, per #133.
See https://gitlab.gnome.org/GNOME/gnome-user-docs/-/commit/cd521453c21e6332a92f0da3a92d6e749581df0f and https://gitlab.gnome.org/GNOME/gnome-user-docs/-/commit/a92d6f460d86bfe97e975032fbfea899aa051dfb for very similar examples of what needs to be done.https://gitlab.gnome.org/GNOME/gnome-user-docs/-/issues/152Make mentions of Super Key have ⌘ icon in Help Page / Menus2024-03-03T09:36:08ZHenry RabeloMake mentions of Super Key have ⌘ icon in Help Page / Menus
### Feature summary
One thing that routinely throws off new users coming to Linux is getting accustomed to the new layouts and lingo that come with any new platform.
One thing that I can personally attest to being confused by when I s...
### Feature summary
One thing that routinely throws off new users coming to Linux is getting accustomed to the new layouts and lingo that come with any new platform.
One thing that I can personally attest to being confused by when I started learning was knowing what was the fabled **Super key**. While after searching I got used to it being called Super, I believe it would be **way more friendly** to new users if there was a **recognizable icon** that accompanied it after citations, given that it has always been represented with an icon.
The icon would need to be well known enough, so that new users could likely figure it out without having to search much further. While I recognize that the GNOME Help page has a good reference to what it is, many new users might never properly search the Help app, or not know that it is referenced there.
### How would you like it to work
Having explained my reasoning, I believe it would be useful to utilize the **Looped Square icon** (⌘, Unicode U+2318) after the Super key being cited in help pages and menus, as such:
`Super ⌘`
The icon is **recognizable enough** by the majority of people, and its function is **generally understood** as being the same as the Windows/Super key. Furthermore, it is **not a copyrighted symbol**, **nor a OS specific symbol**. It is officially referred to as the **Point of Interest symbol**. It is both in form and function a splendid icon to be used to refer to the Super key.
### Relevant links, screenshots, screencasts etc.
https://en.wikipedia.org/wiki/Looped_square
https://cassidyjames.com/blog/why-the-looped-square-symbol/
<!-- Do not remove the following line. -->https://gitlab.gnome.org/GNOME/gnome-user-docs/-/issues/150Add docs on nautilus scripts2022-02-28T18:53:06ZShaun McCanceAdd docs on nautilus scriptshttps://gitlab.gnome.org/GNOME/gnome-user-docs/-/issues/122Explain printer protocols when manually adding a new printer2022-09-10T15:21:38ZFederico BruniExplain printer protocols when manually adding a new printer"Set up a local printer" page doesn't cover this possible scenario:
![add-printer-protocol](/uploads/8b1e2c963f7f510bca15f9cc6d5dfe58/add-printer-protocol.png)
Which printer would you pick? JetDirect, LPD or that other weird address?
..."Set up a local printer" page doesn't cover this possible scenario:
![add-printer-protocol](/uploads/8b1e2c963f7f510bca15f9cc6d5dfe58/add-printer-protocol.png)
Which printer would you pick? JetDirect, LPD or that other weird address?
Tested on Fedora 34, GNOME 40.0.https://gitlab.gnome.org/GNOME/gnome-user-docs/-/issues/121Check on gesture documentation for 412023-10-07T10:56:58ZShaun McCanceCheck on gesture documentation for 41In issue #104, we updated the gesture documentation for 40. The shell revamp introduced new gestures and got rid of old ones, and it seems there were documented gestures that may have been removed or changed earlier. We also introduced n...In issue #104, we updated the gesture documentation for 40. The shell revamp introduced new gestures and got rid of old ones, and it seems there were documented gestures that may have been removed or changed earlier. We also introduced new illustrations that look a lot better.
But I wasn't able to test everything. So for 41:
- [x] Jakub made an illustration for dragging from the top of a touchscreen to leave fullscreen. I was unable to test.
- [x] Jakub made an illustration for dragging from the bottom of a touchscreen to get the on-screen keyboard. I was unable to test.
- [ ] We used to have entries for dragging down the system menu and notification menu on a touchscreen. I was unable to test. It was pointed out that these are just special cases to make tapping easier. And there are obvious tap targets there, so maybe it doesn't need documenting?
- [ ] We used to have a gesture for switching apps, sort of like Alt+Tab. You held three fingers down, then tapped with a fourth. Is this a thing still? I couldn't make it work.
Source illustrations are in https://gitlab.gnome.org/Teams/Design/app-illustrations/-/tree/master/assets/docshttps://gitlab.gnome.org/GNOME/gnome-user-docs/-/issues/120Consider adding instructions on how to use hotspot QR code from other devices2023-09-14T18:23:14ZShaun McCanceConsider adding instructions on how to use hotspot QR code from other devicesIn !106, @rohmishra proposed adding instructions on how to use the QR code for a wireless hotspot on other devices. I don't want to try to push this into 40, and it doesn't fit well in our small task format. But I have some ideas on how ...In !106, @rohmishra proposed adding instructions on how to use the QR code for a wireless hotspot on other devices. I don't want to try to push this into 40, and it doesn't fit well in our small task format. But I have some ideas on how to document additional tasks and material that I'd like to visit in 41. So let's keep this on the radar for then.https://gitlab.gnome.org/GNOME/gnome-user-docs/-/issues/119Write docs on Thunderbolt2024-02-26T10:54:38ZShaun McCanceWrite docs on ThunderboltThunderbolt docks are a big deal right now, but they come with a host of privacy concerns and user experience nightmares. The top bar will even show an icon when the system is probing a Thunderbolt device. There's a whole settings panel ...Thunderbolt docks are a big deal right now, but they come with a host of privacy concerns and user experience nightmares. The top bar will even show an icon when the system is probing a Thunderbolt device. There's a whole settings panel under `Privacy & Security > Devices` for it. So, it needs docs.
Incidentally, I had to follow these command-line instructions to get my Thunderbolt dock working:
https://laptrinhx.com/ben-cotton-solved-ports-on-thinkpad-thunderbolt-dock-doesn-t-work-with-fedora-1533935194/
Some day I might be brave enough to revoke permissions and try to do it again with just the GUI so I can write better docs.