Merge pull request #19322 from cincodenada/patch-1

packages/@ember/-internals/routing/lib/ext/controller.ts

@@ -14,19 +14,22 @@ ControllerMixin.reopen({
     If you give the names `['category','page']` it will bind
     the values of these query parameters to the variables
     `this.category` and `this.page`.
-    By default, Ember coerces query parameter values using `toggleProperty`.
-    This behavior may lead to unexpected results.
-    Available queryParam types: `boolean`, `number`, `array`.
-    If query param type not specified, it will be `string`.
-    To explicitly configure a query parameter property so it coerces as expected, you must define a type property:
 
+    By default, query parameters are parsed as strings. This
+    may cause unexpected behavior if a query parameter is used with `toggleProperty`,
+    because the initial value set for `param=false` will be the string `"false"`, which is truthy.
+
+    To avoid this, you may specify that the query parameter should be parsed as a boolean
+    by using the following verbose form with a `type` property:
     ```javascript
       queryParams: [{
         category: {
           type: 'boolean'
         }
       }]
     ```
+    Available values for the `type` parameter are `'boolean'`, `'number'`, `'array'`, and `'string'`.
+    If query param type is not specified, it will default to `'string'`.
 
     @for Ember.ControllerMixin
     @property queryParams