Enum extensions - format description as jsdoc instead of comments

[DavidDeSloovere]

Description

Using the enum extension --enum, the description of enum values is now written as a // comment. It also doesn't handle new lines correctly.

enum ErrorCode {
  // User is not authorized
  Unauthorized = 100
  // User has no access to this resource
  AccessDenied = 200
  // Something went wrong line 1
This is line 2
This is line 3
  Unknown = 300
}

Proposal

The description could be written as jsdoc, improving DX when using the client.
This could also handle new lines correctly.

enum ErrorCode {
  /** User is not authorized */
  Unauthorized = 100
  /** User has no access to this resource */
  AccessDenied = 200
  /** 
   * Something went wrong line 1
   * This is line 2
   * This is line 3 
   */
  Unknown = 300
}

Checklist

• I’m willing to open a PR for this (see CONTRIBUTING.md)

If you can give me some instruction on where to start and how to format jsdocs correctly, I could probably make this work.

[gzm0]

Sounds very reasonable to me (@drwpow ?)