Remove screenshots of Toolbox on top of all tool pages
In the III. Function Reference > Tools
section of https://testing.docs.gimp.org/2.99/en/ , screenshots of the GIMP Toolbox are (sometimes) displayed on top of pages for a specific tool or group of tools.
There are many problems:
-
Tool grouping: The toolbox screenshots assume that the tools in your Toolbox are ungrouped, however grouping is the default since 2.10.8 (via
Preferences > Toolbox > Use tool groups
). -
Tool order customization: In addition, it is possible since 2.10.8 to customize the order of tool icons in the toolbox (via
Preferences > Toolbox > Tools Configuration
). - Icon order: The order of items is outdated: For example nowadays by default, Move and Align come before Rectangle Select, etc.
- Toolbox width: The toolbox screenshots inconsistently show random widths of Toolbox (different number of items per row). Users may also resize the width of the Toolbox. Thus these screenshots of the Toolbox provide no cognitive help to find a tool in the Toolbox.
- Theme/icon sets: The theme and icon sets used are inconsistent: Some have a light background color, some have an old paper background color, some have a "darker" background color. Some use the color icon themeset, some use the legacy icon themeset, Some use the symbolic icon themeset.
- Highlighting: The way how to highlight a tool in the toolbox is inconsistent: Some screenshots use a pressed tool button, some manually grey-opaque everything around the tool button, some manually create a red square around the tool button, some manually create a red circle around the tool button.
- Inconsistently used: The toolbox screenshot concept is not consistently used across tool pages: For example, https://testing.docs.gimp.org/2.99/en/gimp-tool-transform-3d.html or https://testing.docs.gimp.org/2.99/en/gimp-tool-gradient.html do not have any such screenshot. Looks like we can survive without. <3
- Cropping: The cropping of the toolbox screenshots is inconsistent: Some also contain the color and indicator area below the tools, some not. Some contain the GIMP drag&drop area above the tools, some not.
-
File names: As a documentation writer, the screenshot file name scheme is inconsistent: It is cumbersome to find all screenshots to potentially update due to their random naming (
toolbox-nameOfTool.png
versusnameOfTool-toolbox.png
versus the outlinerhandle-transform.png
). - Unjustified exposure: The "Activating the Tool" text section covers the often three ways to access the tool. Selecting a tool in the toolbox is just one out of (often) three ways. It makes no sense to give it such exposure on the very top of a tool documentation page.
Thus I propose to remove these "toolbox with a single tool icon highlighted" screenshots from the description page of a tool.
For the records and your own inspection:
Dark theme, symbolic icon theme, pressed tool button:
- https://testing.docs.gimp.org/2.99/en/images/toolbox/toolbox-scale.png
- https://testing.docs.gimp.org/2.99/en/images/toolbox/toolbox-crop.png
Light or grey theme, legacy or color icon theme, pressed tool button:
- https://testing.docs.gimp.org/2.99/en/images/toolbox/toolbox-icons.jpg
- https://testing.docs.gimp.org/2.99/en/images/toolbox/FG-select-toolbox.png
- https://testing.docs.gimp.org/2.99/en/images/toolbox/toolbox-path.png
- https://testing.docs.gimp.org/2.99/en/images/toolbox/toolbox-text.png
- https://testing.docs.gimp.org/2.99/en/images/toolbox/toolbox-eyedropper.png
- https://testing.docs.gimp.org/2.99/en/images/toolbox/toolbox-measure.png
- https://testing.docs.gimp.org/2.99/en/images/toolbox/toolbox-zoom.png
- https://testing.docs.gimp.org/2.99/en/images/toolbox/cage-toolbox.png
- https://testing.docs.gimp.org/2.99/en/images/toolbox/align-toolbox.png
- https://testing.docs.gimp.org/2.99/en/images/toolbox/toolbox-scissor.png
- https://testing.docs.gimp.org/2.99/en/images/toolbox/toolbox-selbycolor.png
- https://testing.docs.gimp.org/2.99/en/images/toolbox/toolbox-lasso.png
- https://testing.docs.gimp.org/2.99/en/images/toolbox/toolbox-ellipsel.png
- https://testing.docs.gimp.org/2.99/en/images/toolbox/toolbox-rectsel.png
Light theme, legacy or color icon theme, manual red square around tool button:
- https://testing.docs.gimp.org/2.99/en/images/toolbox/handle-transform.png
- https://testing.docs.gimp.org/2.99/en/images/toolbox/toolbox-fill.png
- https://testing.docs.gimp.org/2.99/en/images/toolbox/smudge-toolbox.png
- https://testing.docs.gimp.org/2.99/en/images/toolbox/toolbox-fuzzy-select.png
Light theme, legacy or color icon theme, manual red circle around tool button:
- https://testing.docs.gimp.org/2.99/en/images/toolbox/MyPaint-brush-toolbox.png
- https://testing.docs.gimp.org/2.99/en/images/toolbox/warp-toolbox.png
Light theme, legacy color icon theme, everything manually opaque-greyed around tool button:
- https://testing.docs.gimp.org/2.99/en/images/toolbox/toolbox-pencil.png
- https://testing.docs.gimp.org/2.99/en/images/toolbox/toolbox-brush.png
- https://testing.docs.gimp.org/2.99/en/images/toolbox/toolbox-eraser.png
- https://testing.docs.gimp.org/2.99/en/images/toolbox/toolbox-airbrush.png
- https://testing.docs.gimp.org/2.99/en/images/toolbox/toolbox-pen.png
- https://testing.docs.gimp.org/2.99/en/images/toolbox/toolbox-clone.png
- https://testing.docs.gimp.org/2.99/en/images/toolbox/toolbox-heal.png
- https://testing.docs.gimp.org/2.99/en/images/toolbox/toolbox-perspective-clone.png
- https://testing.docs.gimp.org/2.99/en/images/toolbox/toolbox-blur.png
- https://testing.docs.gimp.org/2.99/en/images/toolbox/toolbox-dodge.png
- https://testing.docs.gimp.org/2.99/en/images/toolbox/toolbox-move.png
- https://testing.docs.gimp.org/2.99/en/images/toolbox/toolbox-rotate.png
- https://testing.docs.gimp.org/2.99/en/images/toolbox/toolbox-shear.png
- https://testing.docs.gimp.org/2.99/en/images/toolbox/toolbox-perspective.png
- https://testing.docs.gimp.org/2.99/en/images/toolbox/toolbox-flip.png