From 0aa828a9bea49ecb74d541910b8e7e08c92850bc Mon Sep 17 00:00:00 2001
From: Michael Kauzmann <michael.kauzmann@colorado.edu>
Date: Mon, 6 Mar 2023 10:45:45 -0700
Subject: [PATCH] add doc, https://github.com/phetsims/phet-core/issues/105

---
 js/optionize.ts | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/js/optionize.ts b/js/optionize.ts
index 84b7513..8ac4aa2 100644
--- a/js/optionize.ts
+++ b/js/optionize.ts
@@ -52,7 +52,7 @@ const merge4 = ( a: IntentionalAny, b?: IntentionalAny, c?: IntentionalAny, d?:
 // ParentOptions = The public API for parent options, this will be exported by the parent class, like "NodeOptions"
 // KeysUsedInSubclassConstructor = list of keys from ParentOptions that are used in this constructor.
 export default function optionize<ProvidedOptions,
-  SelfOptions = ProvidedOptions,
+  SelfOptions = ProvidedOptions, // By default, every optional option in the ProvidedOptions must have a default unless you specify another object for SelfOptions
   ParentOptions = Record<never, never>>():
   <KeysUsedInSubclassConstructor extends keyof ( ParentOptions )>(
     defaults: OptionizeDefaults<SelfOptions, ParentOptions, ProvidedOptions>,
@@ -63,7 +63,7 @@ export default function optionize<ProvidedOptions,
 
 // Use this function to gain the typing that optionize provides but in a case where the first argument is an empty object.
 export function optionize3<ProvidedOptions,
-  SelfOptions = ProvidedOptions,
+  SelfOptions = ProvidedOptions, // By default, every optional option in the ProvidedOptions must have a default unless you specify another object for SelfOptions
   ParentOptions = Record<never, never>>():
   <KeysUsedInSubclassConstructor extends keyof ( ParentOptions )>(
     emptyObject: ObjectWithNoKeys,