Add some specific documentation for uploading files

API.md

@@ -170,6 +170,20 @@ Triggers an event on the specified target.
 -   `eventType` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** the type of event to trigger
 -   `options` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** additional properties to be set on the event
 
+**Examples**
+
+_Using triggerEvent to Upload a file
+When using triggerEvent to upload a file the `eventType` must be `change` and  you must pass an
+array of [Blob](https://developer.mozilla.org/en-US/docs/Web/API/Blob) as `options`._
+
+```javascript
+triggerEvent(
+  'input.fileUpload',
+  'change',
+  [new Blob(['Ember Rules!'])]
+);
+```
+
 Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<void>** resolves when the application is settled
 
 ### triggerKeyEvent

addon-test-support/@ember/test-helpers/dom/trigger-event.js

@@ -4,14 +4,25 @@ import settled from '../settled';
 import { nextTickPromise } from '../-utils';
 
 /**
-  Triggers an event on the specified target.
-
-  @public
-  @param {string|Element} target the element or selector to trigger the event on
-  @param {string} eventType the type of event to trigger
-  @param {Object} options additional properties to be set on the event
-  @return {Promise<void>} resolves when the application is settled
-*/
+ * Triggers an event on the specified target.
+ *
+ * @public
+ * @param {string|Element} target the element or selector to trigger the event on
+ * @param {string} eventType the type of event to trigger
+ * @param {Object} options additional properties to be set on the event
+ * @return {Promise<void>} resolves when the application is settled
+ *
+ * @example
+ * <caption>Using triggerEvent to Upload a file
+ * When using triggerEvent to upload a file the `eventType` must be `change` and  you must pass an
+ * array of [Blob](https://developer.mozilla.org/en-US/docs/Web/API/Blob) as `options`.</caption>
+ *
+ * triggerEvent(
+ *   'input.fileUpload',
+ *   'change',
+ *   [new Blob(['Ember Rules!'])]
+ * );
+ */
 export default function triggerEvent(target, eventType, options) {
   return nextTickPromise().then(() => {
     if (!target) {