Move comments to the appropriate location (#438)

Comments are helpful when placed above the class in IDEs or with YARD.

Author: Yang-33

generator/src/main/resources/line-bot-sdk-ruby-generator/model.pebble

@@ -6,14 +6,20 @@
 {% if model.model.parent != null %}
 require_relative './{{ model.model.parent | underscore }}'
 {% endif -%}
-{% if model.model.description != null %}
-# {{ model.model.description }}{% endif %}{% if model.model.externalDocumentation.description != null %}
-# {{ model.model.externalDocumentation.description }}{% endif %}{% if model.model.externalDocumentation.url != null %}
-# @see {{ model.model.externalDocumentation.url }}{% endif %}
+{{ "" | raw }}{# To break line #}
 module Line
   module Bot
     module V2
       module {{ packageName | camelize }}
+        {% if model.model.description != null -%}
+        # {{ model.model.description }}
+        {% endif -%}
+        {% if model.model.externalDocumentation.description != null -%}
+        # {{ model.model.externalDocumentation.description }}
+        {% endif -%}
+        {% if model.model.externalDocumentation.url != null -%}
+        # @see {{ model.model.externalDocumentation.url }}
+        {% endif -%}
         class {{ model.model.classname }}{% if model.model.parent != null %} < {{ model.model.parent }}{% endif %}
           {%- for property in model.model.vars %}
           {% if model.model.vendorExtensions.get("x-selector").propertyName != property.name %}attr_accessor{% else %}attr_reader{% endif %} :{{ property.name }}{% if property.description != null %} # {{ property.description }}{% endif %}

generator/src/main/resources/line-bot-sdk-ruby-rbs-generator/model.pebble

@@ -2,19 +2,19 @@
 {# @pebvariable name="packageName" type="String" #}
 {%- for model in models -%}
 {% include "./license.pebble" %}
-{% if model.model.description != null -%}
-# {{ model.model.description }}
-{% endif -%}
-{% if model.model.externalDocumentation.description != null -%}
-# {{ model.model.externalDocumentation.description }}
-{% endif -%}
-{% if model.model.externalDocumentation.url != null -%}
-# @see {{ model.model.externalDocumentation.url }}
-{% endif -%}
 module Line
   module Bot
     module V2
       module {{ packageName | camelize }}
+        {% if model.model.description != null -%}
+        # {{ model.model.description }}
+        {% endif -%}
+        {% if model.model.externalDocumentation.description != null -%}
+        # {{ model.model.externalDocumentation.description }}
+        {% endif -%}
+        {% if model.model.externalDocumentation.url != null -%}
+        # @see {{ model.model.externalDocumentation.url }}
+        {% endif -%}
         class {{ model.model.classname }}{% if model.model.parent != null %} < {{ model.model.parent }}{% endif %}
           {% if not model.model.isEnum -%}
           {% for variable in model.model.vars -%}

lib/line/bot/v2/channel_access_token/model/channel_access_token_key_ids_response.rb

@@ -7,12 +7,12 @@
 # https://openapi-generator.tech
 # Do not edit the class manually.
 
-# Channel access token key IDs
-# @see https://developers.line.biz/en/reference/messaging-api/#get-all-valid-channel-access-token-key-ids-v2-1
 module Line
   module Bot
     module V2
       module ChannelAccessToken
+        # Channel access token key IDs
+        # @see https://developers.line.biz/en/reference/messaging-api/#get-all-valid-channel-access-token-key-ids-v2-1
         class ChannelAccessTokenKeyIdsResponse
           attr_accessor :kids # Array of channel access token key IDs.
 

lib/line/bot/v2/channel_access_token/model/error_response.rb

@@ -7,11 +7,11 @@
 # https://openapi-generator.tech
 # Do not edit the class manually.
 
-# Error response of the Channel access token
 module Line
   module Bot
     module V2
       module ChannelAccessToken
+        # Error response of the Channel access token
         class ErrorResponse
           attr_accessor :error # Error summary
           attr_accessor :error_description # Details of the error. Not returned in certain situations.

lib/line/bot/v2/channel_access_token/model/issue_channel_access_token_response.rb

@@ -7,12 +7,12 @@
 # https://openapi-generator.tech
 # Do not edit the class manually.
 
-# Issued channel access token
-# @see https://developers.line.biz/en/reference/messaging-api/#issue-channel-access-token-v2-1
 module Line
   module Bot
     module V2
       module ChannelAccessToken
+        # Issued channel access token
+        # @see https://developers.line.biz/en/reference/messaging-api/#issue-channel-access-token-v2-1
         class IssueChannelAccessTokenResponse
           attr_accessor :access_token # Channel access token. 
           attr_accessor :expires_in # Amount of time in seconds from issue to expiration of the channel access token

lib/line/bot/v2/channel_access_token/model/issue_short_lived_channel_access_token_response.rb

@@ -7,12 +7,12 @@
 # https://openapi-generator.tech
 # Do not edit the class manually.
 
-# Issued short-lived channel access token
-# @see https://developers.line.biz/en/reference/messaging-api/#issue-shortlived-channel-access-token
 module Line
   module Bot
     module V2
       module ChannelAccessToken
+        # Issued short-lived channel access token
+        # @see https://developers.line.biz/en/reference/messaging-api/#issue-shortlived-channel-access-token
         class IssueShortLivedChannelAccessTokenResponse
           attr_accessor :access_token # A short-lived channel access token. Valid for 30 days. Note: Channel access tokens cannot be refreshed. 
           attr_accessor :expires_in # Time until channel access token expires in seconds from time the token is issued.

lib/line/bot/v2/channel_access_token/model/issue_stateless_channel_access_token_response.rb

@@ -7,12 +7,12 @@
 # https://openapi-generator.tech
 # Do not edit the class manually.
 
-# Issued stateless channel access token
-# @see https://developers.line.biz/en/reference/messaging-api/#issue-stateless-channel-access-token
 module Line
   module Bot
     module V2
       module ChannelAccessToken
+        # Issued stateless channel access token
+        # @see https://developers.line.biz/en/reference/messaging-api/#issue-stateless-channel-access-token
         class IssueStatelessChannelAccessTokenResponse
           attr_accessor :access_token # A stateless channel access token. The token is an opaque string which means its format is an implementation detail and the consumer of this token should never try to use the data parsed from the token. 
           attr_accessor :expires_in # Duration in seconds after which the issued access token expires

lib/line/bot/v2/channel_access_token/model/verify_channel_access_token_response.rb

@@ -7,11 +7,11 @@
 # https://openapi-generator.tech
 # Do not edit the class manually.
 
-# Verification result
 module Line
   module Bot
     module V2
       module ChannelAccessToken
+        # Verification result
         class VerifyChannelAccessTokenResponse
           attr_accessor :client_id # The channel ID for which the channel access token was issued.
           attr_accessor :expires_in # Number of seconds before the channel access token expires.

lib/line/bot/v2/insight/model/error_response.rb

@@ -7,11 +7,11 @@
 # https://openapi-generator.tech
 # Do not edit the class manually.
 
-# @see https://developers.line.biz/en/reference/messaging-api/#error-responses
 module Line
   module Bot
     module V2
       module Insight
+        # @see https://developers.line.biz/en/reference/messaging-api/#error-responses
         class ErrorResponse
           attr_accessor :message # Message containing information about the error.
           attr_accessor :details # An array of error details. If the array is empty, this property will not be included in the response.

lib/line/bot/v2/insight/model/get_friends_demographics_response.rb

@@ -7,12 +7,12 @@
 # https://openapi-generator.tech
 # Do not edit the class manually.
 
-# Get friend demographics
-# @see https://developers.line.biz/en/reference/messaging-api/#get-demographic
 module Line
   module Bot
     module V2
       module Insight
+        # Get friend demographics
+        # @see https://developers.line.biz/en/reference/messaging-api/#get-demographic
         class GetFriendsDemographicsResponse
           attr_accessor :available # true if friend demographic information is available.
           attr_accessor :genders # Percentage per gender.