From 271f2d1665b88b13ce737960e84019dfcbbb759a Mon Sep 17 00:00:00 2001
From: Bradley Schofield <ionicisere@gmail.com>
Date: Tue, 4 Feb 2025 12:56:30 +0900
Subject: [PATCH] Remove titles from descriptions

---
 .../library/src/main/java/io/package/services/Service.kt.twig | 4 ----
 templates/apple/Sources/Services/Service.swift.twig           | 4 ----
 templates/dart/lib/services/service.dart.twig                 | 2 --
 templates/deno/src/services/service.ts.twig                   | 2 --
 templates/dotnet/Package/Services/ServiceTemplate.cs.twig     | 4 ----
 templates/flutter/lib/services/service.dart.twig              | 2 --
 .../main/kotlin/io/appwrite/services/ServiceTemplate.kt.twig  | 4 ----
 templates/node/src/services/template.ts.twig                  | 2 --
 templates/php/docs/service.md.twig                            | 1 -
 templates/php/src/Services/Service.php.twig                   | 2 --
 templates/python/package/services/service.py.twig             | 3 ---
 templates/react-native/src/services/template.ts.twig          | 2 --
 templates/swift/Sources/Services/Service.swift.twig           | 4 ----
 templates/web/src/services/template.ts.twig                   | 2 --
 14 files changed, 38 deletions(-)

diff --git a/templates/android/library/src/main/java/io/package/services/Service.kt.twig b/templates/android/library/src/main/java/io/package/services/Service.kt.twig
index ef94f0d88..351ed8cc9 100644
--- a/templates/android/library/src/main/java/io/package/services/Service.kt.twig
+++ b/templates/android/library/src/main/java/io/package/services/Service.kt.twig
@@ -29,8 +29,6 @@ class {{ service.name | caseUcfirst }}(client: Client) : Service(client) {
 
 {% for method in service.methods %}
     /**
-     * {{ method.title }}
-     *
      * {{ method.description | raw | replace({"\n": "", "\r": ""}) }}
      *
     {%~ for parameter in method.parameters.all %}
@@ -185,8 +183,6 @@ class {{ service.name | caseUcfirst }}(client: Client) : Service(client) {
 
     {%~ if method.responseModel | hasGenericType(spec) %}
     /**
-     * {{ method.title }}
-     *
      * {{ method.description | raw | replace({"\n": "", "\r": ""}) }}
      *
     {%~ for parameter in method.parameters.all %}
diff --git a/templates/apple/Sources/Services/Service.swift.twig b/templates/apple/Sources/Services/Service.swift.twig
index 234919b48..d3226c144 100644
--- a/templates/apple/Sources/Services/Service.swift.twig
+++ b/templates/apple/Sources/Services/Service.swift.twig
@@ -10,8 +10,6 @@ open class {{ service.name | caseUcfirst | overrideIdentifier }}: Service {
 
     {%~ for method in service.methods %}
     ///
-    /// {{ method.title }}
-    ///
     {%~ if method.description %}
     {{~ method.description | swiftComment }}
     ///
@@ -75,8 +73,6 @@ open class {{ service.name | caseUcfirst | overrideIdentifier }}: Service {
     }
     {%~ if method.responseModel | hasGenericType(spec) %}
 
-    ///
-    /// {{ method.title }}
     ///
     {%~ if method.description %}
     {{~ method.description | swiftComment }}
diff --git a/templates/dart/lib/services/service.dart.twig b/templates/dart/lib/services/service.dart.twig
index ae930dbba..b7ea9048f 100644
--- a/templates/dart/lib/services/service.dart.twig
+++ b/templates/dart/lib/services/service.dart.twig
@@ -14,8 +14,6 @@ class {{ service.name | caseUcfirst }} extends Service {
     {{ service.name | caseUcfirst }}(super.client);
 {% for method in service.methods %}
 
-    /// {{ method.title }}
-    ///
 {%~ if method.description %}
 {{ method.description | dartComment }}
 {% endif %}
diff --git a/templates/deno/src/services/service.ts.twig b/templates/deno/src/services/service.ts.twig
index ca3c00ff2..fedf272a5 100644
--- a/templates/deno/src/services/service.ts.twig
+++ b/templates/deno/src/services/service.ts.twig
@@ -68,8 +68,6 @@ export class {{ service.name | caseUcfirst }} extends Service {
 {% set generics = _self.get_generics(spec.definitions[method.responseModel], spec, true, true) %}
 {% set generics_return = _self.get_generics_return(spec.definitions[method.responseModel], spec) %}
     /**
-     * {{ method.title }}
-     *
 {% if method.description %}
 {{ method.description|comment1 }}
      *
diff --git a/templates/dotnet/Package/Services/ServiceTemplate.cs.twig b/templates/dotnet/Package/Services/ServiceTemplate.cs.twig
index c20801c06..1fb9321c1 100644
--- a/templates/dotnet/Package/Services/ServiceTemplate.cs.twig
+++ b/templates/dotnet/Package/Services/ServiceTemplate.cs.twig
@@ -20,10 +20,6 @@ namespace {{ spec.title | caseUcfirst }}.Services
         }
 
         {%~ for method in service.methods %}
-        {%~ if method.title %}
-        /// <summary>
-        /// {{ method.title }}
-        {%~ endif %}
         {%~ if method.description %}
         /// <para>
         {{~ method.description | dotnetComment }}
diff --git a/templates/flutter/lib/services/service.dart.twig b/templates/flutter/lib/services/service.dart.twig
index 206045105..829c312bb 100644
--- a/templates/flutter/lib/services/service.dart.twig
+++ b/templates/flutter/lib/services/service.dart.twig
@@ -15,8 +15,6 @@ class {{ service.name | caseUcfirst }} extends Service {
     {{ service.name | caseUcfirst }}(super.client);
 {% for method in service.methods %}
 
-    /// {{ method.title }}
-    ///
 {%~ if method.description %}
 {{ method.description|dartComment }}
 {% endif %}
diff --git a/templates/kotlin/src/main/kotlin/io/appwrite/services/ServiceTemplate.kt.twig b/templates/kotlin/src/main/kotlin/io/appwrite/services/ServiceTemplate.kt.twig
index c5add5d0f..3e6f356cb 100644
--- a/templates/kotlin/src/main/kotlin/io/appwrite/services/ServiceTemplate.kt.twig
+++ b/templates/kotlin/src/main/kotlin/io/appwrite/services/ServiceTemplate.kt.twig
@@ -23,8 +23,6 @@ class {{ service.name | caseUcfirst }}(client: Client) : Service(client) {
 
 {% for method in service.methods %}
     /**
-     * {{ method.title }}
-     *
      * {{ method.description | raw | replace({"\n": "", "\r": ""}) }}
      *
     {%~ for parameter in method.parameters.all %}
@@ -86,8 +84,6 @@ class {{ service.name | caseUcfirst }}(client: Client) : Service(client) {
     {%~ if method.responseModel | hasGenericType(spec) %}
 
     /**
-     * {{ method.title }}
-     *
      * {{ method.description | raw | replace({"\n": "", "\r": ""}) }}
      *
     {%~ for parameter in method.parameters.all %}
diff --git a/templates/node/src/services/template.ts.twig b/templates/node/src/services/template.ts.twig
index 47a20cdc7..e0a72b836 100644
--- a/templates/node/src/services/template.ts.twig
+++ b/templates/node/src/services/template.ts.twig
@@ -26,8 +26,6 @@ export class {{ service.name | caseUcfirst }} {
 
     {%~ for method in service.methods %}
     /**
-     * {{ method.title }}
-     *
     {%~ if method.description %}
      * {{ method.description }}
     {%~ endif %}
diff --git a/templates/php/docs/service.md.twig b/templates/php/docs/service.md.twig
index 783962710..3f8eb0b9c 100644
--- a/templates/php/docs/service.md.twig
+++ b/templates/php/docs/service.md.twig
@@ -1,7 +1,6 @@
 # {{ service.name | caseUcfirst }} Service
 
 {% for method in service.methods %}
-## {{ method.title }}
 
 ```http request
 {{ method.method | caseUpper }} {{ spec.endpoint }}{{ method.path }}
diff --git a/templates/php/src/Services/Service.php.twig b/templates/php/src/Services/Service.php.twig
index b524cb6a4..0061fd2e6 100644
--- a/templates/php/src/Services/Service.php.twig
+++ b/templates/php/src/Services/Service.php.twig
@@ -32,8 +32,6 @@ class {{ service.name | caseUcfirst }} extends Service
 
 {% for method in service.methods %}
     /**
-     * {{ method.title }}
-     *
 {% if method.description %}
 {{ method.description|comment1 }}
      *
diff --git a/templates/python/package/services/service.py.twig b/templates/python/package/services/service.py.twig
index 4f617e437..76bc86431 100644
--- a/templates/python/package/services/service.py.twig
+++ b/templates/python/package/services/service.py.twig
@@ -8,10 +8,7 @@ class {{ service.name | caseUcfirst }}(Service):
 {% for method in service.methods %}
 
     def {{ method.name | caseSnake }}(self{% if method.parameters.all|length > 0 %}, {% endif %}{% for parameter in method.parameters.all %}{{ parameter.name | escapeKeyword | caseSnake }}{% if not parameter.required %} = None{% endif %}{% if not loop.last %}, {% endif %}{% endfor %}{% if 'multipart/form-data' in method.consumes %}, on_progress = None{% endif %}):
-{% if method.title %}
-        """{{ method.title }}"""
 
-{% endif %}        
         api_path = '{{ method.path }}'
 {{ include('python/base/params.twig') }}
 {% if 'multipart/form-data' in method.consumes %}
diff --git a/templates/react-native/src/services/template.ts.twig b/templates/react-native/src/services/template.ts.twig
index c816df6dd..ba69e50be 100644
--- a/templates/react-native/src/services/template.ts.twig
+++ b/templates/react-native/src/services/template.ts.twig
@@ -31,8 +31,6 @@ export class {{ service.name | caseUcfirst }} extends Service {
 {% for method in service.methods %}
 
     /**
-     * {{ method.title }}
-     *
 {% if method.description %}
 {{ method.description|comment2 }}
 {% endif %}
diff --git a/templates/swift/Sources/Services/Service.swift.twig b/templates/swift/Sources/Services/Service.swift.twig
index c14e9b975..6d74ee44b 100644
--- a/templates/swift/Sources/Services/Service.swift.twig
+++ b/templates/swift/Sources/Services/Service.swift.twig
@@ -10,8 +10,6 @@ open class {{ service.name | caseUcfirst | overrideIdentifier }}: Service {
 
     {%~ for method in service.methods %}
     ///
-    /// {{ method.title }}
-    ///
     {%~ if method.description %}
     {{~ method.description | swiftComment }}
     ///
@@ -72,8 +70,6 @@ open class {{ service.name | caseUcfirst | overrideIdentifier }}: Service {
     }
     {%~ if method.responseModel | hasGenericType(spec) %}
 
-    ///
-    /// {{ method.title }}
     ///
     {%~ if method.description %}
     {{~ method.description | swiftComment }}
diff --git a/templates/web/src/services/template.ts.twig b/templates/web/src/services/template.ts.twig
index fcf61ef7f..ba072c809 100644
--- a/templates/web/src/services/template.ts.twig
+++ b/templates/web/src/services/template.ts.twig
@@ -27,8 +27,6 @@ export class {{ service.name | caseUcfirst }} {
 
     {%~ for method in service.methods %}
     /**
-     * {{ method.title }}
-     *
     {%~ if method.description %}
      * {{ method.description }}
     {%~ endif %}