Tweak Script class API docs (#7501)

Author: willeastcott

src/framework/script/script.js

@@ -15,11 +15,11 @@ import { SCRIPT_INITIALIZE, SCRIPT_POST_INITIALIZE } from './constants.js';
  * At its core, a script is simply a collection of methods that are called at various points in the
  * Engine's lifecycle. These methods are:
  *
- * {@link Script#initialize} - Called once when the script is initialized
- * {@link Script#postInitialize} - Called once after all scripts have been initialized
- * {@link Script#update} - Called every frame, if the script is enabled
- * {@link Script#postUpdate} - Called every frame, after all scripts have been updated
- * {@link Script#swap} - Called when a script is redefined
+ * - `Script#initialize` - Called once when the script is initialized.
+ * - `Script#postInitialize` - Called once after all scripts have been initialized.
+ * - `Script#update` - Called every frame, if the script is enabled.
+ * - `Script#postUpdate` - Called every frame, after all scripts have been updated.
+ * - `Script#swap` - Called when a script is redefined.
  *
  * These methods are entirely optional, but provide a useful way to manage the lifecycle of a
  * script and perform any necessary setup and cleanup.
@@ -28,7 +28,7 @@ import { SCRIPT_INITIALIZE, SCRIPT_POST_INITIALIZE } from './constants.js';
  * @example
  * ```javascript
  * class EntityRotator extends Script {
- *     update() {
+ *     update(dt) {
  *         this.entity.rotateLocal(0, 1, 0);
  *     }
  * }
@@ -153,14 +153,14 @@ export class Script extends EventHandler {
     static EVENT_ERROR = 'error';
 
     /**
-     * The {@link AppBase} that the instance of this type belongs to.
+     * The {@link AppBase} that the instance of this script belongs to.
      *
      * @type {AppBase}
      */
     app;
 
     /**
-     * The {@link Entity} that the instance of this type belongs to.
+     * The {@link Entity} that the instance of this script belongs to.
      *
      * @type {Entity}
      */
@@ -206,11 +206,11 @@ export class Script extends EventHandler {
     }
 
     /**
-     * True if the instance of this type is in running state. False when script is not running,
+     * True if the instance of this script is in running state. False when script is not running,
      * because the Entity or any of its parents are disabled or the {@link ScriptComponent} is
-     * disabled or the Script Instance is disabled. When disabled no update methods will be called
-     * on each tick. initialize and postInitialize methods will run once when the script instance
-     * is in `enabled` state during app tick.
+     * disabled or the Script Instance is disabled. When disabled, no update methods will be called
+     * on each tick. `initialize` and `postInitialize` methods will run once when the script
+     * instance is in the `enabled` state during an app tick.
      *
      * @type {boolean}
      */