Named params or comments with param names for allll

Author: Vincent (Wen Yu) Ge

templates/android/docs/java/example.md.twig

@@ -26,10 +26,10 @@ Client client = new Client(context)
 
 {% for parameter in method.parameters.all %}
 {% if parameter.required %}
-    {{ parameter | paramExample }}{% if not loop.last %},{% endif %}
+    {{ parameter | paramExample }}{% if not loop.last %},{% endif %} // {{parameter.name}}
 
 {% else %}
-    {{ parameter | paramExample }}{% if not loop.last %},{% endif %} // optional
+    {{ parameter | paramExample }}{% if not loop.last %},{% endif %} // {{parameter.name}} (optional)
 {% endif %}
 {% if loop.last %}
     new CoroutineCallback<>((result, error) -> {

templates/deno/docs/example.md.twig

@@ -22,10 +22,10 @@ const promise = {{ service.name | caseCamel }}.{{ method.name | caseCamel }}({%
 {% if loop.first %}
 
     {% endif %}{% if parameter.required %}
-    {{ parameter | paramExample }}{% if not loop.last %}, {% endif %}
+    {{ parameter | paramExample }}{% if not loop.last %}, {% endif %} // {{parameter.name}}
 
     {% else %}
-    {{ parameter | paramExample }}{% if not loop.last %}, {% endif %} // optional
+    {{ parameter | paramExample }}{% if not loop.last %}, {% endif %} // {{parameter.name}} (optional)
     {% endif %}{% endfor %});
 
 promise.then(function (response) {

templates/kotlin/docs/java/example.md.twig

@@ -26,10 +26,10 @@ Client client = new Client()
 
 {% for parameter in method.parameters.all %}
 {% if parameter.required %}
-    {{ parameter | paramExample }}{% if not loop.last %},{% endif %}
+    {{ parameter | paramExample }}{% if not loop.last %},{% endif %} // {{parameter.name}}
 
 {% else %}
-    {{ parameter | paramExample }}{% if not loop.last %},{% endif %} // optional
+    {{ parameter | paramExample }}{% if not loop.last %},{% endif %} // {{parameter.name}} (optional)
 {% endif %}
 {% if loop.last %}
     new CoroutineCallback<>((result, error) -> {

templates/node/docs/example.md.twig

@@ -22,10 +22,10 @@ const promise = {{ service.name | caseCamel }}.{{ method.name | caseCamel }}({%
 {% if loop.first %}
 
     {% endif %}{% if parameter.required %}
-    {{ parameter | paramExample }}{% if not loop.last %}, {% endif %}
+    {{ parameter | paramExample }}{% if not loop.last %}, {% endif %} // {{parameter.name}}
 
     {% else %}
-    {{ parameter | paramExample }}{% if not loop.last %}, {% endif %} // optional
+    {{ parameter | paramExample }}{% if not loop.last %}, {% endif %} // {{parameter.name}} (optional)
     {% endif %}{% endfor %});
 
 promise.then(function (response) {

templates/php/docs/example.md.twig

@@ -22,8 +22,8 @@ ${{ service.name | caseCamel }} = new {{ service.name | caseUcfirst }}($client{%
 
 $result = ${{ service.name | caseCamel }}->{{ method.name | caseCamel }}({% for parameter in method.parameters.all %}{% if loop.first %} 
 {% endif %}
-    {% if parameter.required %}{{ parameter | paramExample }}{% if not loop.last %}, {% endif %}
+    {% if parameter.required %}{{ parameter.name }}: {{ parameter | paramExample }}{% if not loop.last %}, {% endif %}
 
-{% else %}{{ parameter | paramExample }}{% if not loop.last %}, {% endif %} // optional
+{% else %}{{ parameter.name }}: {{ parameter | paramExample }}{% if not loop.last %}, {% endif %} // optional
 {% endif %}{% endfor %}
 );

templates/python/docs/example.md.twig

@@ -20,8 +20,9 @@ client = Client()
 
 result = {{ service.name | caseSnake }}.{{ method.name | caseSnake }}({% for parameter in method.parameters.all %}{% if loop.first %} 
 {% endif %}
-    {% if parameter.required %}{{ parameter | paramExample }}{% if not loop.last %}, {% endif %}
+    {% if parameter.required %}{{ parameter.name | caseSnake }} = {{ parameter | paramExample }}{% if not loop.last %}, {% endif %}
 
-{% else %}{{ parameter | paramExample }}{% if not loop.last %}, {% endif %} # optional
+{% else %}{{ parameter.name | caseSnake }} = {{ parameter | paramExample }}{% if not loop.last %}, {% endif %} # optional
 {% endif %}{% endfor %}
 )
+

templates/web/docs/example.md.twig

@@ -20,10 +20,10 @@ client
 {% if loop.first %}
 
     {% endif %}{% if parameter.required %}
-    {{ parameter | paramExample }}{% if not loop.last %}, {% endif %}
+    {{ parameter | paramExample }}{% if not loop.last %}, {% endif %} // {{parameter.name}}
 
     {% else %}
-    {{ parameter | paramExample }}{% if not loop.last %}, {% endif %} // optional
+    {{ parameter | paramExample }}{% if not loop.last %}, {% endif %} // {{parameter.name}} (optional)
     {% endif %}{% endfor %});
 
 {% if method.type == 'webAuth' %}{% elseif method.type == 'location' %}console.log(result); // Resource URL{% else %}promise.then(function (response) {