3.2.4 of the 22.04.1 LTS manual is about the Panel and Panels.
Nowhere in that section is there any description of what, preceively, a "Panel" actually is. There's an image that contains (what I think is) a Panel, but the reader is left to guess that maybe it has something to do with the horizontal bar at the bottom of the image.
Or maybe at the top of the image. It's not clear.
When introducing the idea of "Panels", the manual should start by describing what a Panel is (same goes for other UI elements). Experienced Linux users probably already know, but this manual isn't for them.
Then under the image 3.2.4 says:
You can left-click the button
on the far right side of the panel to alter the properties of the panel, like changing its height or width or adding Widgets,
for example.
Two problems here. (1) It's unclear to the reader what a Panel is, so she doesn't know where to look for the button. (2) there is no single obvious button on the right side of anything, do (at least this reader) doesn't know what button is being referred to.
3.2.4 of the 22.04.1 LTS manual is about the Panel and Panels.
Nowhere in that section is there any description of what, preceively, a "Panel" actually is. There's an image that contains (what I think is) a Panel, but the reader is left to guess that maybe it has something to do with the horizontal bar at the bottom of the image.
Or maybe at the top of the image. It's not clear.
When introducing the idea of "Panels", the manual should start by describing what a Panel is (same goes for other UI elements). Experienced Linux users probably already know, but this manual isn't for them.
Then under the image 3.2.4 says:
Two problems here. (1) It's unclear to the reader what a Panel is, so she doesn't know where to look for the button. (2) there is no single obvious button on the right side of anything, do (at least this reader) doesn't know what button is being referred to.