# ...
generation:
  comments:
    disabled: true
```

### Operation Comments

Comments for each method in the generated SDK will be generated from the summary or description of the Operation. For example, if you have an Operation like the following:

```yaml
paths:
  /pets:
    get:
      operationId: listPets
      summary: List all pets
      description: Get a list of all pets in the system
      responses:
        "200":
          description: A list of pets
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: "#/components/schemas/Pet"
```

The generated SDK will have a method commented like so:

<CodeWithTabs
  tabs={[
    {
      label: "Go",
      language: "go",
      code: `// ListPets - List all pets
  // Get a list of all pets in the system
  func (s *SDK) ListPets(ctx context.Context) (*operations.ListPetsResponse, error) {
  // ...
  }`,
    },
    {
      label: "Python",
      language: "python",
      code: `def list_pets(self) -> operations.ListPetsResponse:
      r"""List all pets
      Get a list of all pets in the system
      """
      # ...`,
    },
    {
      label: "TypeScript",
      language: "typescript",
      code: `  /**
      * ListPets - List all pets
      *
      * Get a list of all pets in the system
      */
    ListPets(
      config?: AxiosRequestConfig
    ): Promise<operations.ListPetsResponse> {
      // ...
    }`,
    },
    {
      label: "Java",
      language: "java",
      code: `  /**
      * ListPets - List all pets
      *
      * Get a list of all pets in the system
      **/
      public ListPetsResponse listPets() {
        // ...
    }`,
    },
    {
      label: "C#",
      language: "csharp",
      code: `/// <summary>
  /// List all pets
  ///
  /// <remarks>
  /// Get a list of all pets in the system
  /// </remarks>
  /// </summary>
  Task<ListPetsResponse> ListPetsAsync();`,
    },
  ]}
/>

If both the summary and description are present, the summary will be used as the first line of the comment and the description will be used as the second line of the comment. If just the description is present, it will be used as the first line of the comment. If both are present, but you would like to omit the description as it might be too verbose, you can use the `omitdescriptionifsummarypresent` option in your `gen.yaml` file, as follows:

```yaml