docs: reword descriptions

Author: timdeschryver

projects/testing-library/src/lib/models.ts

@@ -8,15 +8,17 @@ export type RenderResultQueries<Q extends Queries = typeof queries> = { [P in ke
 export interface RenderResult extends RenderResultQueries, FireObject, UserEvents {
   /**
    * @description
-   * The HTML of the rendered component
+   * The containing DOM node of your rendered Angular Component.
+   * This is a regular DOM node, so you can call container.querySelector etc. to inspect the children.
    */
   container: HTMLElement;
   /**
    * @description
-   * Prints out the component's HTML with syntax highlighting
+   * Prints out the component's DOM with syntax highlighting.
+   * Accepts an optional parameter, to print out a specific DOM node.
    *
    * @param
-   * element: The to be printed HTML element, if not provided it will log the whole component's HTML
+   * element: The to be printed HTML element, if not provided it will log the whole component's DOM
    */
   debug: (element?: HTMLElement) => void;
   /**

projects/testing-library/src/lib/user-events/index.ts

@@ -5,11 +5,11 @@ import { createSelectOptions } from './selectOptions';
 export interface UserEvents {
   /**
    * @description
-   * Types a value in an input field just like the user would do
+   * Types a value in an input field with the same interactions as the user would do.
    *
    * @argument
    * element: HTMLElement - the form field to type in
-   * value: string - the value to type in
+   * value: string | number - the value to type in
    *
    * @example
    * component.type(component.getByLabelText('Firstname'), 'Tim')
@@ -20,7 +20,7 @@ export interface UserEvents {
 
   /**
    * @description
-   * Select an option(s) from a select just like the user would do
+   * Select an option(s) from a select field with the same interactions as the user would do.
    *
    * @argument
    * element: HTMLElement - the select box to select an option in

projects/testing-library/src/lib/user-events/type.ts

@@ -9,7 +9,7 @@ function wait(time) {
 export interface TypeOptions {
   /**
    * @description
-   * Write the text at once rather than on character at a time
+   * Types the text at once rather than on character at a time
    *
    * @default
    * false