Documentation updates

Author: wallstop

CHANGELOG.md

@@ -9,6 +9,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 See [the roadmap](./docs/overview/roadmap.md) for details
 
+## [3.1.0]
+
 ### Added
 
 - **Pool Access Frequency Tracking**: Intelligent purge decisions based on pool usage patterns
@@ -57,10 +59,7 @@ See [the roadmap](./docs/overview/roadmap.md) for details
   - Lifecycle hooks automatically registered via `RuntimeInitializeOnLoadMethod`
 - **RandomExtensions `NextOfExcept`**: New extension methods for selecting random elements with exclusions
   - `NextOfExcept(values)` - no exclusions (convenience overload)
-  - `NextOfExcept(values, exception1)` - exclude one value
-  - `NextOfExcept(values, exception1, exception2)` - exclude two values
-  - `NextOfExcept(values, exception1, exception2, exception3)` - exclude three values
-  - `NextOfExcept(values, exceptions)` - exclude arbitrary set of values
+  - `NextOfExcept(values, exception1...)` - exclude values
   - Zero-allocation using pooled collections internally
 
 ### Changed
@@ -71,7 +70,7 @@ See [the roadmap](./docs/overview/roadmap.md) for details
   - `DefaultHysteresisSeconds` defaults to `120` (was `60`)
   - `DefaultSpikeThresholdMultiplier` defaults to `2.5` (was `2.0`)
   - Use `PoolPurgeSettings.DisableGlobally()` to restore previous behavior
-  - `UnityMainThreadDispatcher` auto-load behavior has changed from auto-loading to not auto-loading (you will need to manually create it.)
+  - `UnityMainThreadDispatcher` auto-load behavior has changed from auto-loading to not auto-loading.
   - `UnityMainThreadDispatcher` hide flags have been changed to `None`.
 
 - **DictionaryExtensions `ToDictionary`**: Now uses last-wins semantics for duplicate keys instead of throwing `ArgumentException`

README.md

@@ -452,7 +452,7 @@ Add to your `Packages/manifest.json`:
     }
   ],
   "dependencies": {
-    "com.wallstop-studios.unity-helpers": "2.2.0"
+    "com.wallstop-studios.unity-helpers": "3.1.0"
   }
 }
 ```
@@ -475,7 +475,7 @@ Install directly from GitHub for the latest version:
 }
 ```
 
-> **Tip:** To lock to a specific version, append `#v2.2.0` to the URL.
+> **Tip:** To lock to a specific version, append `#3.1.0` to the URL.
 
 ### From NPM Registry
 

docs/features/effects/effects-system-tutorial.md

@@ -136,8 +136,7 @@ Select `HasteEffect` and set these values in Inspector:
 
 **Tags:**
 
-- Effect Tags: Add tag `"Haste"`
-- Grant Tags: Add tag `"Haste"` (allows gameplay queries)
+- Effect Tags: Add `"Haste"` (used for both gameplay queries via `HasTag()` and effect organization)
 
 ### 3.3 Add Visual Effects (Optional)
 
@@ -219,8 +218,7 @@ Let's make a more complex effect that prevents movement.
 
 **Tags:**
 
-- Effect Tags: `"Stun"`, `"Debuff"`
-- Grant Tags: `"Stunned"`, `"CC"` (crowd control)
+- Effect Tags: `"Stunned"`, `"Stun"`, `"Debuff"`, `"CC"` (for gameplay queries and organization)
 
 ### 5.3 Query Tags in Gameplay
 

docs/features/effects/effects-system.md

@@ -2100,17 +2100,20 @@ public class DebugConsole : MonoBehaviour
    /// Burning - Takes fire damage over time, can ignite others
    ```
 
-4. **Use effect tags for internal organization**
+4. **Use effect tags for multiple purposes**
 
    ```csharp
-   // EffectTags vs GrantTags:
-   // - EffectTags: Internal organization (removable via GetHandlesWithTag + RemoveEffects)
-   // - GrantTags: Gameplay queries (checked via HasTag)
+   // effectTags serve multiple purposes:
+   // - Internal organization (removable via GetHandlesWithTag + RemoveEffects)
+   // - Gameplay queries (checked via HasTag)
+   // - Effect identification and categorization
 
    // Example effect:
    // HastePotion.asset:
-   //   - effectTags: ["Potion", "Buff", "Consumable"]  // For removal/organization
-   //   - grantTags: ["Haste", "MovementBuff"]          // For gameplay queries
+   //   - effectTags: ["Haste", "Potion", "Buff", "MovementBuff"]
+   //   - Use "Haste" for gameplay queries (player.HasTag("Haste"))
+   //   - Use "Potion" for finding/removing all potions
+   //   - Use "Buff" for UI categorization
    ```
 
 5. **Test tag combinations** - Verify interactions work correctly

docs/images/unity-helpers-banner.svg

@@ -1,6 +1,6 @@
 {
   "name": "com.wallstop-studios.unity-helpers",
-  "version": "3.0.5",
+  "version": "3.1.0",
   "displayName": "Unity Helpers",
   "description": "Treasure chest of Unity developer tools ",
   "unity": "2021.3",