Merge branch 'restore-decorator-support_contribute-9.0' into restore-decorator-support_contribute-main

Author: nona-luypaert

scripts/config/decorator-config.interface.ts

@@ -1,9 +1,16 @@
 import { DecoratorParam } from './decorator-param.interface';
 
 /**
- * The configuration of dynamic component decorators. This is used to generate the registry files.
+ * The configuration for a dynamic component decorator. This is used to generate the registry files.
  */
 export interface DecoratorConfig {
+  /**
+   * Name of the decorator
+   */
   name: string;
+
+  /**
+   * List of DecoratorParams
+   */
   params: DecoratorParam[];
 }

scripts/config/decorator-param.interface.ts

@@ -1,5 +1,5 @@
 /**
- * The configuration of a parameter from a decorator
+ * The configuration for a decorator parameter.
  */
 export interface DecoratorParam {
   /**
@@ -8,14 +8,19 @@ export interface DecoratorParam {
   name: string;
 
   /**
-   * The default value if any of the decorator param
+   * The default value of the decorator param
+   *
+   * (Optional)
    */
   default?: string;
 
   /**
-   * The property of the provided value that should be used instead to generate the Map. So, for example, if the
-   * decorator value is a {@link ResourceType}, you may want to use the `ResourceType.value` instead of the whole
-   * {@link ResourceType} object. In this case the {@link DecoratorParam#property} would be `value`.
+   * The property of the provided parameter value that should be used instead of the value itself.
+   *
+   * For example, if the parameter value is {@link ResourceType} 'BITSTREAM', you'll want to use 'BITSTREAM.value'
+   * instead of the whole {@link ResourceType} object. In this case the {@link DecoratorParam#property} is `value`.
+   *
+   * (Optional)
    */
   property?: string;
 }