README.md

@@ -17,6 +17,7 @@ Run the operator again to restore everything to how it was before.
 
 I recommend setting up a keybind for this, eg.:  
 <img src="docs/toggle_wp_shortcut.png" width="400" />  
+If you don't want to use the hotkey editor, you can also just find the operator in the "Object" or "Weights" menus, and simply Right Click->Assign Shortcut.
 
 ### Weight Paint Context Menu
 The default context menu (accessed via W key or Right Click) for weight paint mode is not very useful.
@@ -24,24 +25,31 @@ The Custom Weight Paint Context Menu operator is intended as a replacement for i
 <img src="docs/custom_wp_context_menu.png" width="250" />  
 _(The "OK" button is not needed, I just can't avoid it)_  
 
+This panel provides quick access to commonly needed tools, whether they are part of core Blender or the addon:
+- Global toggles for the Accumulate, Front Faces Only and Falloff Shape brush options.
+- Weight Paint mode settings including new ["Clean Weights"](#clean-weights) option
+- Commonly used Overlay and Armature display settings
+- Commonly used or [new](#vertex-group-operators) operators
 It lets you change the brush falloff type (Sphere/Projected) and the Front Faces Only option. These will affect ALL brushes.  
 Also, the color of your brushes will be darker when you're using Sphere falloff.  
 
 I recommend to overwrite the shortcut of the default weight paint context menu like so:  
 <img src="docs/wp_context_menu_shortcut.png" width="500" />  
 
-### Toggle Weight Cleaner
+### Clean Weights
 This is a new functionality found in the custom WP context menu. When enabled, **this will run the Clean Vertex Groups operator after every brush stroke** while you're in weight paint mode. This means 0-weights are automatically removed as they appear, which helps avoid small weight islands and rogue weights appearing as you work.
 
 ### Vertex Group Operators
 The Vertex Groups context menu is re-organized with more icons and better labels, as well as some additional operators:
 <img src="docs/vg_context_menu.png" width="500" />  
-- **Delete Empty Deform Groups**: Delete deforming groups that don't have any weights.
-- **Delete Unused Non-Deform Groups**: Delete non-deforming groups that aren't used anywhere, even if they do have weights.
-- **Delete Unselected Deform Groups**: Delete all deforming groups that don't correspond to a selected pose bone. Only in Weight Paint mode.
-- **Ensure Mirror Groups**: If your object has a Mirror modifier, this will create any missing vertex groups.
-- **Focus Deforming Bones**: Reveal and select all bones deforming this mesh. Only in Weight Paint mode.
-TODO: Operators to hunt down rogue weights and ensure symmetrical weights.
+- **Delete Empty Deform Groups**: Delete deforming groups that don't have any weights.  
+- **Delete Unused Non-Deform Groups**: Delete non-deforming groups that aren't used anywhere, even if they do have weights.  
+- **Delete Unselected Deform Groups**: Delete all deforming groups that don't correspond to a selected pose bone. Only in Weight Paint mode.  
+- **Ensure Mirror Groups**: If your object has a Mirror modifier, this will create any missing vertex groups.  
+- **Focus Deforming Bones**: Reveal and select all bones deforming this mesh. Only in Weight Paint mode.  
+- **Focus Rogue Weights**: This real clever operator will cycle through vertex groups whose weights consist of more than a single island, then enter vertex masking mode and select the vertices of the smallest island. This still requires human eyes to check and make sure the islands are definitely not needed. You are meant to run this operator many times over and over to cycle through such vertex groups.  
+TODO: Operator to ensure symmetrical weights.
+If you have any more suggestions, feel free to open an Issue with a feature request.
 
 ### Force Apply Mirror Modifier
 In Blender, you cannot apply a mirror modifier to meshes that have shape keys.