Merge pull request #540 from appwrite/fix-doc-comments

Update to fix param description being escaped

Author: christyjacob4

specs/swagger2-latest-console.json

@@ -39,7 +39,7 @@ class {{ service.name | caseUcfirst }} : Service {
      *
 {% endif %}
 {% for parameter in method.parameters.all %}
-     * @param {{ parameter.name | caseCamel }} {{ parameter.description }}
+     * @param {{ parameter.name | caseCamel }} {{ parameter.description | raw }}
 {% endfor %}
      * {% if method.type != "webAuth" %}@return [{{ _self.resultType(sdk.namespace, method) }}]{% endif %}
 

templates/android/library/src/main/java/io/appwrite/services/ServiceTemplate.kt.twig

@@ -28,7 +28,7 @@ class {{ service.name | caseUcfirst }} : Service {
      *
 {% endif %}
 {% for parameter in method.parameters.all %}
-     * @param {{ parameter.name | caseCamel }} {{ parameter.description }}
+     * @param {{ parameter.name | caseCamel }} {{ parameter.description | raw }}
 {% endfor %}
      * {% if method.type != "webAuth" %}@return [{{ utils.resultType(sdk.namespace, method) }}]{% endif %}
 

templates/kotlin/src/main/kotlin/io/appwrite/services/ServiceTemplate.kt.twig

@@ -18,22 +18,22 @@
 | --- | --- | --- | --- |
 {% if method.parameters.path | length > 0 %}
 {% for parameter in method.parameters.path %}
-| {{ parameter.name }} | {{ parameter.type }} | {% if parameter.required == 1 %}**Required** {% endif %}{{ parameter.description }} | {{ parameter.default }} |
+| {{ parameter.name }} | {{ parameter.type }} | {% if parameter.required == 1 %}**Required** {% endif %}{{ parameter.description | raw }} | {{ parameter.default }} |
 {% endfor %}
 {% endif %}
 {% if method.parameters.query | length > 0 %}
 {% for parameter in method.parameters.query %}
-| {{ parameter.name }} | {{ parameter.type }} | {% if parameter.required == 1 %}**Required** {% endif %}{{ parameter.description }} | {{ parameter.default }} |
+| {{ parameter.name }} | {{ parameter.type }} | {% if parameter.required == 1 %}**Required** {% endif %}{{ parameter.description | raw }} | {{ parameter.default }} |
 {% endfor %}
 {% endif %}
 {% if method.parameters.body | length > 0 %}
 {% for parameter in method.parameters.body %}
-| {{ parameter.name }} | {{ parameter.type }} | {{ parameter.description }} | {{ parameter.default }} |
+| {{ parameter.name }} | {{ parameter.type }} | {{ parameter.description | raw }} | {{ parameter.default }} |
 {% endfor %}
 {% endif %}
 {% if method.parameters.formData | length > 0 %}
 {% for parameter in method.parameters.formData %}
-| {{ parameter.name }} | {{ parameter.type }} | {{ parameter.description }} | {{ parameter.default }} |
+| {{ parameter.name }} | {{ parameter.type }} | {{ parameter.description | raw }} | {{ parameter.default }} |
 {% endfor %}
 {% endif %}
 

templates/php/docs/service.md.twig

@@ -11,7 +11,7 @@ module {{spec.title | caseUcfirst}}
 {{ method.description | rubyComment }}
         #
 {% for parameter in method.parameters.all %}
-        # @param [{{ parameter | typeName }}] {{ parameter.name | caseSnake | escapeKeyword }} {{ parameter.description }}
+        # @param [{{ parameter | typeName }}] {{ parameter.name | caseSnake | escapeKeyword }} {{ parameter.description | raw }}
 {% endfor %}
         #
         # @return [{{ method.responseModel | caseUcfirst }}]