bump to 3.0

content/hub/docs/folder/Technical-Guide.md

@@ -73,7 +73,7 @@ A convert branch is used to adjust the latest GIMP master branch to support the
 
 The current strategy is to place any heavily modified file that supports multiple feature branches—through the addition of new data structures—into a convert branch. This approach helps consolidate overlapping changes in one place, while maintaining the core code that performs the main functions in separate feature branches.
 
-The convert branches are:
+The current convert branches are:
 
 - **convert-to-artbox:** The main branch that combines all other convert branches.
   - **convert-data-remote:** Handles the gimp-data remote url.
@@ -96,16 +96,11 @@ These conflicts can be resolved fairly easily due to the automated construction
 
 #### Example of a Convert Branch
 
-A unusually complex convert branch like 'convert-paintbrush-all-merged' is itself a combined branch that integrates multiple smaller changes.
+A unusually complex convert branch like 'convert-paintbrush-all-merged' is a branch that integrates multiple smaller changes, it's commit history is more than one change.
 
 - convert-paintbrush-all-merged: Integrates modifications to the paintbrush tool, history is intact.
-  - convert-paintbrush-simple-boundary
-  - convert-paintbrush-simple-boundary
-  - convert-paintbrush-status-alt
-  - convert-paintbrush-erase
-  ...
 
-These sub-branches implement smaller, specific changes. If a conflict arises between convert-paintbrush-all-merged and the GIMP development branch, an interactive rebase can be done to edit and resolve that particular commit.
+If a conflict arises between convert-paintbrush-all-merged and the GIMP development branch, an interactive rebase can be done to edit and resolve that particular commit.
 
 ### Feature Branches
 

content/hub/feature-test/folder/Dynamic-Velocity-Output.md

@@ -4,28 +4,29 @@ type: docs
 
 # Objective
 
-Make sense of the mapping graphs for dynamic features by removing the velocity inversion.
+Remove the velocity inversion, so that the dynamic mapping graphs representation is accurate.
 
 ## Related Links
 
 - Branches: Artbox and [feature-remove-inverted-dynamic-velocity](https://gitlab.gnome.org/pixelmixer/artbox/-/tree/feature-remove-inverted-dynamic-velocity?ref_type=heads)
+- https://gitlab.gnome.org/GNOME/gimp/-/issues/958
 
 ## Design Revisions
 
 | **Revision**  | **Current Design**  | **Issues**  | **Changes** |
 |--------------------------------------------|---------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------|-----------------------------------------------------------|
-| **1. Remove Velocity Inversion** | Velocity is math inverted | The max and min values are inverted in the spacing curve graph  | The velocity math is not inverted and the graph for velocity mapping is accurate |
+| **1. Remove Velocity Inversion** | The velocity calculations are inverted | The maximum and minimum values are inverted in the spacing curve graph  | The velocity calculations are no longer inverted, and the velocity mapping graph is accurate |
 
 ## MR Description
 
-This MR removes the velocity inversion in the dynamic features, ensuring the velocity mapping is more intuitive and accurate.
+This merge request removes the velocity inversion in dynamics, simplifying the velocity mapping for easier use.
 
 ### Changes
 
 - **Remove Velocity Inversion**:
   - The velocity is no longer inverted (`1.0 - coords->velocity` removed).
-  - Now, `coords->velocity` is mapped directly, making the graph for velocity mapping more accurate.
+  - `coords->velocity` is mapped directly, making the graph for velocity mapping more accurate.
 
 ### Benefit
 
-- This change ensures that the velocity mapping in the dynamic features behaves correctly, making it easier for users to understand and control their brush settings without inverted values.
+- This change corrects the velocity mapping in dynamic features, helping users understand and control brush settings without dealing with inverted values.

content/hub/feature-test/folder/Paintbrush-Options.md

@@ -1,7 +1,3 @@
----
-type: docs
----
-
 # Objective
 
 Improve the usability of the Paintbrush GUI.
@@ -14,18 +10,19 @@ Improve the usability of the Paintbrush GUI.
 
 ## Related Links
 
-- Branches: Artbox and [feature-paintbrush-options](https://gitlab.gnome.org/pixelmixer/artbox/-/tree/feature-paintbrush-options?ref_type=heads)
+- Branches: Artbox and [convert-paintbrush-all-merged](https://gitlab.gnome.org/pixelmixer/artbox/-/tree/convert-paintbrush-all-merged?ref_type=heads)
 
 ## Design Revisions
 
-| **Revision**  | **Current Design**  | **Issues**  | **Changes** |
-|--------------------------------------------|---------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------|-----------------------------------------------------------|
-| **1. Remove Reset Brush Button** | Option sliders have a reset button to default values. | Rarely used; adds complexity to the GUI. | Remove the reset to default button. |
-| **2. Remove Brush Link Button**   | Brush link button allows linking to brush editor options. | Difficult to explain and justify; causes confusion | Remove the link button. |
-| **3. Add Expander for Additional Options** | Options added to the end of paintbrush settings; more options will be added in the future   | Lesser-used options clutter the interface and reduce dock space efficiency | Add an "Additional Options" expander for lesser-used items |
-| **4. Separate Dynamics** | 'Enable Dynamics' contains the 'Fade and Colour' options| The 'Fade and Colour' options take up a lot of space, and do not need to be visible all the time.| Add a "Dynamic Fade and Colour" expander, visible when Enable Dynamics is checked |
-| **5. Compact Resource Chooser** | Picking a resource such as a brush or a dynamic is done via a chooser, see the Paintbrush GUI | The chooser is takes up two rows of the dockable due to a label above the combo box. The icons on either side are distorted to fill the gap, which looks bad. GUI space is wasted | Remove the label and the chooser becomes compact. The purpose of the chooser is self evident and does not need a label|
-| **6.Smooth Stroke Position** | 'Smooth Stroke' is in low down in the dock | It's a frequently used option for painting | Move higher up the dock |
+| **Revision** | **Current Design** | **Issues** | **Changes** |
+|--------------|---------------------|------------|-------------|
+| **1. Remove Reset Brush Button** | Option sliders have a reset button to default brush values. | Rarely used in some workflows; adds complexity to the GUI. | Remove the reset to default button. Instead, <kbd>Ctrl + Click</kbd> on the slider to reset it to the brush default. |
+| **2. Adapt Brush Link Button** | Brush link button allows linking to brush editor options and brush changes. | Difficult to explain and used in some workflows, not all; causes confusion. | Rename the button to Brush Update Button. Make it optional via a Tool Options -> Paintbrush preference. Add more clarity and information to the tooltip. |
+| **3. Add Expander for Additional Options** | Options are added to the end of Paintbrush settings; more options will be added in the future. | Lesser-used options clutter the interface and reduce dock space efficiency. | Add an "Additional Options" expander for lesser-used items. |
+| **4. Separate Dynamics** | 'Enable Dynamics' contains the 'Fade and Colour' options. | The 'Fade and Colour' options take up a lot of space and do not need to be visible all the time. | Add a "Dynamic Fade and Colour" expander, visible only when Enable Dynamics is checked. |
+| **5. Compact Resource Chooser** | Picking a resource such as a brush or a dynamic is done via a chooser in the Paintbrush GUI. | The chooser takes up two rows of the dockable panel due to a label above the combo box. The icons on either side are distorted to fill the gap, which looks poor. GUI space is wasted. | Remove the label to make the chooser more compact. The purpose of the chooser is self-evident and does not need a label. |
+| **6. Smooth Stroke Position** | 'Smooth Stroke' is located lower down in the dock. | It’s a frequently used option for painting. | Move it higher up in the dock within 'Stroke Effects'. |
+| **7. Stroke Effects Expander** | New feature. | Options clutter the Paintbrush GUI, or don't flow visually. | Create a 'Stroke Effects' expander to organize these related options. The state of the expander is saved and restored. |
 
 ## MR Description
 
@@ -34,24 +31,27 @@ This MR enhances the Paintbrush GUI in several ways, making it more intuitive an
 ### Changes
 
 1. **Remove Reset Brush Button**:
-     - Removed the reset buttons for brush size, aspect ratio, angle, spacing, and hardness from the Paintbrush options. The code for resetting these properties, along with the corresponding signals, was removed to simplify the interface.
+    - Removed the reset buttons for brush size, aspect ratio, angle, spacing, and hardness from the Paintbrush options. The code for resetting these properties, along with the corresponding signals, was removed to simplify the interface.
 
 2. **Remove Brush Link Button**:
-     - Removed the 'Link to Brush Editor' button, which previously allowed linking the paintbrush options to the brush editor options. This simplifies the GUI by removing a confusing feature that was rarely used.
+    - Removed the 'Link to Brush Editor' button, which previously allowed linking the Paintbrush options to the Brush Editor options. This simplifies the GUI by removing a confusing feature that was rarely used.
 
 3. **Add Expander for Additional Options**:
-     - Introduced a new "Additional Options" expander in the Paintbrush options panel. This organizes less frequently used options (such as the 'Lock Brush to View' and 'Simple Brush Boundary' toggles) into a collapsible section, saving space and removing clutter from the GUI.
+    - Introduced a new "Additional Options" expander in the Paintbrush options panel. This organizes less frequently used options (such as 'Lock Brush to View' and 'Simple Brush Boundary' toggles) into a collapsible section, saving space and reducing clutter in the GUI.
 
 4. **Separate Dynamics (Fade and Colour)**:
-     - Moved the 'Fade and Colour' options (related to brush dynamics) into a separate expander that appears only when 'Enable Dynamics' is checked. This keeps the interface cleaner by hiding these advanced options when dynamics are not in use.
-     - Added `fade-multiply` and `brush-pressure-multiply` toggles to enable pressure and fade dynamics, providing more fine-tuned control.
+    - Moved the 'Fade and Colour' options (related to brush dynamics) into a separate expander that appears only when 'Enable Dynamics' is checked. This keeps the interface cleaner by hiding these advanced options when dynamics are not in use.
+    - Added `fade-multiply` and `brush-pressure-multiply` toggles to enable pressure and fade dynamics, providing more fine-tuned control.
 
 5. **Compact Resource Chooser**:
-     - Removed the label from the resource chooser (used for selecting brushes, dynamics, etc.), making the chooser more compact and saving space in the dockable panel. The chooser’s function is self-explanatory, so the label was deemed unnecessary.
+    - Removed the label from the resource chooser (used for selecting brushes, dynamics, etc.), making the chooser more compact and saving space in the dockable panel. The chooser’s function is self-explanatory, so the label was deemed unnecessary.
 
 6. **Smooth Stroke Position**:
-     - Moved the 'Smooth Stroke' options higher up in the Paintbrush options panel, reflecting its frequent use. This improves accessibility and better aligns with user expectations.
+    - Moved the 'Smooth Stroke' options higher up in the Paintbrush options panel, reflecting its frequent use. This improves accessibility and better aligns with user expectations.
+
+7. **Stroke Effects Expander**:
+    - Added a new "Stroke Effects" expander to group related stroke options into one collapsible section. The state of the expander is saved and restored across sessions, preserving the user's preference for a consistent experience.
 
 ### Benefit
 
-- This set of changes significantly improves the usability and efficiency of the Paintbrush GUI. By reducing visual clutter, hiding advanced options behind expanders, and simplifying the interface, users can now navigate the Paintbrush settings more easily while still accessing the features they need.
+This set of changes significantly improves the usability and efficiency of the Paintbrush GUI. By reducing visual clutter, hiding advanced options behind expanders, and simplifying the interface, users can now navigate the Paintbrush settings more easily while still accessing the features they need.

content/hub/feature-test/folder/Path-Tool.md

@@ -0,0 +1,38 @@
+---
+type: docs
+---
+
+# Objective
+
+Enhance path editing features.
+
+## Related Links
+
+- Branches: Artbox, [feature-snap-to-path-distance](https://gitlab.gnome.org/pixelmixer/artbox/-/tree/feature-snap-to-path-distance?ref_type=heads),  [feature-path-editing](https://gitlab.gnome.org/pixelmixer/artbox/-/tree/feature-path-editing?ref_type=heads)
+
+## Design Revisions
+
+| **Revision**  | **Current Design**  | **Issues**  | **Changes** |
+|---------------|---------------------|-------------|-------------|
+| **1. Path Snap Distance** | Snapping uses a single distance for snapping to grid, guides, and paths. | Users can't adjust snapping precision separately for paths. | Introduced an independent `Active Paths` preference option. |
+| **2. Path Visibility Control** | Created don't automatically show visibility. | Users need to manually enable visibility for newly created paths. | Added visibility control for paths at creation via a new `Visible` property. |
+
+## MR Description
+
+This merge request improves the snapping and visibility options for paths, allowing users finer control over snap distances for paths and automatic visibility for new paths.
+
+### Changes
+
+1. **Path Snap Distance**:
+   - Extended the `gimp_image_snap_point` function in `gimpimage-snap.c` to accept new `epsilon_path_x` and `epsilon_path_y` parameters, which allow different snapping tolerances for paths compared to grid or guide snapping.
+   - Updated `gimp_display_shell_snap_coords` to include the `snap_path_distance` property, adding flexibility to set path-specific snap distance through `snap_path_distance` configured in the display.
+
+2. **Path Visibility Control**:
+   - Introduced a new `visible` property in `GimpToolPathPrivate`, allowing paths to be visible upon creation. This property ensures new paths are visible by default unless otherwise configured.
+   - Added `PROP_VISIBLE` to `gimp_tool_path_class_init` in `gimp_tool_path.c` to manage path visibility and bind it to the vector tool settings.
+   - In `gimp_vector_options`, added a new checkbox in the GUI labeled "Visible Path" to control path visibility in the tool options.
+
+### Benefit
+
+- **Improved Snap Control**: Users can now adjust snap distances independently for paths, providing more precise control based on the type of element (e.g., paths versus grids).
+- **Enhanced Workflow with Auto-Visibility**: Automatically making paths visible at creation enhances user feedback and reduces manual toggling, streamlining the editing process.

content/hub/feature-test/folder/Resource-Control.md

@@ -37,7 +37,7 @@ Improve the usability and data saving of resources and Tool Presets in Artbox.
 | **7. Edit Brush deals with Parametric and Image types** | See Brushes Menu items | Confusion over brush types |  Double clicking an image type opens the image for editing, Double clicking a parametric type opens the Brush Editor |
 | **8. Inform the user about locked resources** | Folder locked resources can not be edited | User confusion | An informative message is displayed in the Brush Editor if the resource is locked |
 | **9. Copy and Paste as New Brush** | New Feature | Create a brush from the active drawable | Added to the Brushes Menu via a Script-Fu plug-in |
-
+| **9. Tool Preset Name in Tool Options Title** | New Feature | See the active Tool Preset name requires the Tool Preset Editor to be open or the Tool Preset selector to be in list mode | Added the active Tool Preset name after the Tool name in the Tool Options title. Tool Name | Tool Preset Name |
 ## MR Description
 
 This merge request improves the usability and data-saving mechanisms for resources and Tool Presets in Artbox. Below is a summary of the key changes made to enhance the user experience with resources, including active tool presets, and their associated assets:
@@ -72,6 +72,9 @@ This merge request improves the usability and data-saving mechanisms for resourc
 9. **Save Active Tool Assets:**
    - Introduced a 'Save All Active Tool Assets' feature, allowing users to save all the active tool assets (brush, gradient, palette, dynamics) in a session for easier resource management. Note: the concept of saving a 'tool package' is not yet implemented.
 
+10. **Tool Preset Name in Tool Options Title:**
+   - Added the active Tool Preset name after the Tool name in the Tool Options title. Tool Name | Tool Preset Name.  We can see which Tool Preset is active from the Tool Options Title.
+
 ### Benefit
 
 These changes aim to provide better control over resources and presets, allowing users to manage their assets more intuitively and prevent unintended modifications.

content/hub/feature-test/folder/Simple-Sliders.md

@@ -10,18 +10,20 @@ Simplify the slider interaction and provide a less distracting slider cursor.
 
 | **Revision**  | **Current Design**  | **Issues**  | **Proposed Changes** |
 |---------------|---------------------|-------------|----------------------|
-| **1. Click to Slide** | Clicking the numerical area of the slider does not move the slider. | Adjusting values at the top range requires careful cursor control to avoid accidentally activating the numerical input. | Disable slider activation by a single click in the numerical input area. |
+| **1. Click to Slide** | Clicking the numerical area of the slider does not move the slider. | Adjusting values at the top range requires careful cursor control to avoid accidentally activating the numerical input. | Remove detection of left clicking in the numerical input area. |
+| **2. Click to Enter Number** | Clicking the numerical area of activates the number entry. | This disrupts slider use. | Clicking the slider activates the numerical entry and allows the slider to slide  |
+| **3. Grab icons changed** | Grabbing hand icons are used | This is obscuring and cartoon like | Use sb_up_arrow and sb_h_double_arrow, up and side-to-side. |
 
 ## MR Description
 
-This MR removes the ability to activate the numerical input field with a single click, improving slider usability.
+This MR improving slider usability for painters, interaction is simple.
 It also changes the cursors from grabbing hands to sb_up_arrow and sb_h_double_arrow, up and side-to-side.
 
 ### Benefit
 
 - Sliders will always slide on a single click, improving usability during tasks like painting.
-- Up arrows allow a precise selection and don't visually jump from cursor to hands, less distraction.
 
 ### Loss
 
-- Numerical input must now be adjusted using +/-, arrow keys, page up/down, middle-click, or by double-clicking the numerical area. This change impacts quick single-click numerical edits.
+- Left clicking the numerical input entry will cause the slider to jump to that position and the value will change.
+- User has to adapt by right clicking the numerical input for a number change without slider and value jump.