cleanup comments

ui/app/components/oidc/assignment-form.js

@@ -15,11 +15,13 @@ import { tracked } from '@glimmer/tracking';
  * @onSave={transition-to "vault.cluster.access.oidc.assignments.assignment.details" this.model.name}
  * />
  * ```
- * @callback onCancel
- * @callback onSave
+
  * @param {object} model - The parent's model
- * @param {string} onCancel - callback triggered when cancel button is clicked
- * @param {string} onSave - callback triggered when save button is clicked
+ * @callback {string} onCancel - callback triggered when cancel button is clicked
+ * @callback {string} onSave - callback triggered when save button is clicked
+ * * params when form renders within search-select-with-modal.hbs:
+ * @callback createSearchSelectModel - callback to fire when new item is selected to create in SS+Modal
+ *
  */
 
 export default class OidcAssignmentFormComponent extends Component {

ui/app/components/oidc/client-form.js

@@ -11,12 +11,10 @@ import { task } from 'ember-concurrency';
  * ```js
  * <OidcClientForm @model={{this.model}} />
  * ```
+ * @param {Object} model - oidc client model
  * @callback onCancel - callback triggered when cancel button is clicked
  * @callback onSave - callback triggered on save success
- * @param {Object} model - oidc client model
  * @param {boolean} [isInline=false] - true when form is rendered within a modal
- * * search-select-with-modal.hbs template-specific params:
- * @callback createSearchSelectModel - callback fired when new item is selected to create in SS+Modal
  */
 
 export default class OidcClientForm extends Component {
@@ -25,7 +23,7 @@ export default class OidcClientForm extends Component {
   @tracked modelValidations;
   @tracked errorBanner;
   @tracked invalidFormAlert;
-  @tracked assignmentModel; // model passed to form rendered by ss+modal
+  @tracked assignmentModel; // model for form rendered by ss+modal
   @tracked radioCardGroupValue =
     !this.args.model.assignments || this.args.model.assignments.includes('allow_all')
       ? 'allow_all'
@@ -40,6 +38,7 @@ export default class OidcClientForm extends Component {
     }
   }
 
+  // callback fired by SS+Modal when new item is selected to create
   @action
   createSearchSelectModel({ name }) {
     if (name) {

ui/app/components/policy-form.js

@@ -20,9 +20,9 @@ import trimRight from 'vault/utils/trim-right';
  * @callback onSave - callback triggered when save button is clicked
  * @param {object} model - ember data model from createRecord
  * @param {boolean} [isInline=false] - true when form is rendered within a modal
- * * search-select-with-modal.hbs template-specific params:
+ * * params when form renders within search-select-with-modal.hbs:
  * @param {object} [nameInput] - search input from SS passed as name attr when firing createSearchSelectModel callback
- * @callback createSearchSelectModel - callback triggered when policy type is selected
+ * @callback createSearchSelectModel - callback to fire when new item is selected to create in SS+Modal
  */
 
 export default class PolicyFormComponent extends Component {