message: Doc update: Clarification on cmdlet suppression.
diff: @@ -86,50 +86,54 @@ directive:
  #### Cmdlet Suppression
  -For cmdlet suppression you can either suppress it by **preventing it from being generated (removal), or by preventing it from being exported at module-export time (hiding).**
  +For cmdlet suppression you can either:
  + - remove it: by preventing it from being generated (removal),
  + - hide it: by preventing it from being exported at module-export time
  -##### Cmdlet Removal
  +Note: If a cmdlet is hidden, it still can be be used by custom cmdlets.
  -To remove a cmdlet, you need to provide the ```subject-prefix```, ```subject```, ```verb```, and/or ```variant``` of the cmdlet; then, set the directive property 'remove: true'. For example:
  +##### Cmdlet Hiding (Exportation Suppression)
  +
  +To hide a cmdlet, you need to provide ```subject-prefix```, ```subject```, ```verb```, and/or ```variant``` of the cmdlet; then set 'set.hide: true'. For example:
  ```yaml false
  directive:
  - where:
  - verb: Get
  - subject: Operation
  - remove: true
  + verb: Update
  + subject: Resource
  + set:
  + hide: true
  ```
  -(**Regex**) The following is a **Regex** example:
  +The following is a **Regex** example:
  ```yaml false
  directive:
  - where:
  - subject: Config.*
  - remove: true
  + subject: PetService.*
  + set:
  + hide: true
  ```
  -##### Cmdlet Hiding (Exportation Suppression)
  +##### Cmdlet Removal
  -To hide a cmdlet, you need to provide ```subject-prefix```, ```subject```, ```verb```, and/or ```variant``` of the cmdlet; then set 'set.hide: true'. For example:
  +To remove a cmdlet, you need to provide the ```subject-prefix```, ```subject```, ```verb```, and/or ```variant``` of the cmdlet; then, set the directive property 'remove: true'. For example:
  ```yaml false
  directive:
  - where:
  - verb: Update
  - subject: Resource
  - set:
  - hide: true
  + verb: Get
  + subject: Operation
  + remove: true
  ```
  -The following is a **Regex** example:
  +(**Regex**) The following is a **Regex** example:
  ```yaml false
  directive:
  - where:
  - subject: PetService.*
  - set:
  - hide: true
  + subject: Config.*
  + remove: true
  ```
  #### Parameter Rename
  