diff --git a/docs/references/sites/create-build.md b/docs/references/sites/create-build.md
deleted file mode 100644
index 961d5e63fd..0000000000
--- a/docs/references/sites/create-build.md
+++ /dev/null
@@ -1 +0,0 @@
-Create a new build for an existing site deployment. This endpoint allows you to rebuild a deployment with the updated site configuration, including its install command, build command, and output directory if they have been modified. The build process will be queued and executed asynchronously. The original deployment's code will be preserved and used for the new build.
\ No newline at end of file
diff --git a/docs/references/sites/create-variable.md b/docs/references/sites/create-variable.md
deleted file mode 100644
index bcabbd2170..0000000000
--- a/docs/references/sites/create-variable.md
+++ /dev/null
@@ -1 +0,0 @@
-Create a new site environment variable. These variables can be accessed during build and runtime (server-side rendering) as environment variables.
\ No newline at end of file
diff --git a/docs/references/sites/delete-deployment.md b/docs/references/sites/delete-deployment.md
deleted file mode 100644
index 19c74965bd..0000000000
--- a/docs/references/sites/delete-deployment.md
+++ /dev/null
@@ -1 +0,0 @@
-Delete a code deployment by its unique ID.
\ No newline at end of file
diff --git a/docs/references/sites/get-deployment.md b/docs/references/sites/get-deployment.md
deleted file mode 100644
index 6d73976eb1..0000000000
--- a/docs/references/sites/get-deployment.md
+++ /dev/null
@@ -1 +0,0 @@
-Get a code deployment by its unique ID.
\ No newline at end of file
diff --git a/docs/references/sites/list-deployments.md b/docs/references/sites/list-deployments.md
deleted file mode 100644
index cf91b70abf..0000000000
--- a/docs/references/sites/list-deployments.md
+++ /dev/null
@@ -1 +0,0 @@
-Get a list of all the site's code deployments. You can use the query params to filter your results.
\ No newline at end of file
diff --git a/docs/references/sites/list-variables.md b/docs/references/sites/list-variables.md
deleted file mode 100644
index 8c4e20b453..0000000000
--- a/docs/references/sites/list-variables.md
+++ /dev/null
@@ -1 +0,0 @@
-Get a list of all variables of a specific site.
\ No newline at end of file
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Create.php b/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Create.php
index 15b63c1f70..6885ecde6c 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Create.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Create.php
@@ -53,7 +53,13 @@ class Create extends Action
             ->label('sdk', new Method(
                 namespace: 'functions',
                 name: 'createDeployment',
-                description: '/docs/references/functions/create-deployment.md',
+                description: <<<EOT
+                Create a new function code deployment. Use this endpoint to upload a new version of your code function. To execute your newly uploaded code, you'll need to update the function's deployment to use your new deployment UID.
+
+                This endpoint accepts a tar.gz file compressed with your code. Make sure to include any dependencies your code has within the compressed file. You can learn more about code packaging in the [Appwrite Cloud Functions tutorial](https://appwrite.io/docs/functions).
+
+                Use the "command" param to set the entrypoint used to execute your code.
+                EOT,
                 auth: [AuthType::KEY],
                 responses: [
                     new SDKResponse(
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Functions/Create.php b/src/Appwrite/Platform/Modules/Functions/Http/Functions/Create.php
index e66421b40e..9d89b7edf0 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Functions/Create.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Functions/Create.php
@@ -62,7 +62,9 @@ class Create extends Base
             ->label('sdk', new Method(
                 namespace: 'functions',
                 name: 'create',
-                description: '/docs/references/functions/create.md',
+                description: <<<EOT
+                Create a new function. You can pass a list of [permissions](https://appwrite.io/docs/permissions) to allow different project users or team with access to execute the function using the client API.
+                EOT,
                 auth: [AuthType::KEY],
                 responses: [
                     new SDKResponse(
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Functions/Update.php b/src/Appwrite/Platform/Modules/Functions/Http/Functions/Update.php
index fc10b60229..1c8731655d 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Functions/Update.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Functions/Update.php
@@ -61,7 +61,9 @@ class Update extends Base
             ->label('sdk', new Method(
                 namespace: 'functions',
                 name: 'update',
-                description: '/docs/references/functions/update-function.md',
+                description: <<<EOT
+                Update function by its unique ID.
+                EOT,
                 auth: [AuthType::KEY],
                 responses: [
                     new SDKResponse(
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Functions/XList.php b/src/Appwrite/Platform/Modules/Functions/Http/Functions/XList.php
index 518dda1a40..4b98f409fe 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Functions/XList.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Functions/XList.php
@@ -39,7 +39,9 @@ class XList extends Base
             ->label('sdk', new Method(
                 namespace: 'functions',
                 name: 'list',
-                description: '/docs/references/functions/list-functions.md',
+                description: <<<EOT
+                Get a list of all the project's functions. You can use the query params to filter your results.
+                EOT,
                 auth: [AuthType::KEY],
                 responses: [
                     new SDKResponse(
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Runtimes/XList.php b/src/Appwrite/Platform/Modules/Functions/Http/Runtimes/XList.php
index e7512fa84d..f5d33e5632 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Runtimes/XList.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Runtimes/XList.php
@@ -34,7 +34,9 @@ class XList extends Base
             ->label('sdk', new Method(
                 namespace: 'functions',
                 name: 'listRuntimes',
-                description: '/docs/references/functions/list-runtimes.md',
+                description: <<<EOT
+                Get a list of all runtimes that are currently active on your instance.
+                EOT,
                 auth: [AuthType::KEY],
                 responses: [
                     new SDKResponse(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Builds/Create.php b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Builds/Create.php
index 6f09c291d4..0c5cfc34e4 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Builds/Create.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Builds/Create.php
@@ -39,7 +39,9 @@ class Create extends Action
             ->label('sdk', new Method(
                 namespace: 'sites',
                 name: 'createDeploymentBuild',
-                description: '/docs/references/sites/create-deployment-build.md',
+                description: <<<EOT
+                Create a new build for an existing site deployment. This endpoint allows you to rebuild a deployment with the updated site configuration, including its commands and output directory if they have been modified. The build process will be queued and executed asynchronously. The original deployment's code will be preserved and used for the new build.
+                EOT,
                 auth: [AuthType::KEY],
                 responses: [
                     new SDKResponse(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Builds/Download/Get.php b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Builds/Download/Get.php
index 8871d60463..f86fa591c1 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Builds/Download/Get.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Builds/Download/Get.php
@@ -3,6 +3,11 @@
 namespace Appwrite\Platform\Modules\Sites\Http\Deployments\Builds\Download;
 
 use Appwrite\Extend\Exception;
+use Appwrite\SDK\AuthType;
+use Appwrite\SDK\ContentType;
+use Appwrite\SDK\Method;
+use Appwrite\SDK\MethodType;
+use Appwrite\SDK\Response as SDKResponse;
 use Appwrite\Utopia\Response;
 use Utopia\Database\Database;
 use Utopia\Database\Validator\UID;
@@ -28,13 +33,22 @@ class Get extends Action
             ->desc('Download build')
             ->groups(['api', 'sites'])
             ->label('scope', 'sites.read')
-            ->label('sdk.auth', [APP_AUTH_TYPE_KEY, APP_AUTH_TYPE_JWT])
-            ->label('sdk.namespace', 'sites')
-            ->label('sdk.method', 'getDeploymentBuildDownload')
-            ->label('sdk.description', '/docs/references/sites/get-deployment-build-download.md')
-            ->label('sdk.response.code', Response::STATUS_CODE_OK)
-            ->label('sdk.response.type', '*/*')
-            ->label('sdk.methodType', 'location')
+            ->label('sdk', new Method(
+                namespace: 'sites',
+                name: 'getDeploymentBuildDownload',
+                description: <<<EOT
+                Get a site build content by its unique ID. The endpoint response return with a 'Content-Disposition: attachment' header that tells the browser to start downloading the file to user downloads directory.
+                EOT,
+                auth: [AuthType::KEY, AuthType::JWT],
+                responses: [
+                    new SDKResponse(
+                        code: Response::STATUS_CODE_OK,
+                        model: Response::MODEL_NONE
+                    )
+                ],
+                type: MethodType::LOCATION,
+                contentType: ContentType::ANY,
+            ))
             ->param('siteId', '', new UID(), 'Site ID.')
             ->param('deploymentId', '', new UID(), 'Deployment ID.')
             ->inject('response')
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Builds/Update.php b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Builds/Update.php
index 00d004f8ff..87831670a3 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Builds/Update.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Builds/Update.php
@@ -41,7 +41,9 @@ class Update extends Action
             ->label('sdk', new Method(
                 namespace: 'sites',
                 name: 'updateDeploymentBuild',
-                description: '/docs/references/sites/update-deployment-build.md',
+                description: <<<EOT
+                Cancel an ongoing site deployment build. If the build is already in progress, it will be stopped and marked as canceled. If the build hasn't started yet, it will be marked as canceled without executing. You cannot cancel builds that have already completed (status 'ready') or failed. The response includes the final build status and details.
+                EOT,
                 auth: [AuthType::KEY],
                 responses: [
                     new SDKResponse(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Create.php b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Create.php
index e15324600b..38b9e2aeba 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Create.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Create.php
@@ -53,7 +53,9 @@ class Create extends Action
             ->label('sdk', new Method(
                 namespace: 'sites',
                 name: 'createDeployment',
-                description: '/docs/references/sites/create-deployment.md',
+                description: <<<EOT
+                Create a new site code deployment. Use this endpoint to upload a new version of your site code. To activate your newly uploaded code, you'll need to update the function's deployment to use your new deployment ID.
+                EOT,
                 auth: [AuthType::KEY],
                 responses: [
                     new SDKResponse(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Delete.php b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Delete.php
index 6c8d2203f3..575937a68a 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Delete.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Delete.php
@@ -40,7 +40,9 @@ class Delete extends Action
             ->label('sdk', new Method(
                 namespace: 'sites',
                 name: 'deleteDeployment',
-                description: '/docs/references/sites/delete-deployment.md',
+                description: <<<EOT
+                Delete a site deployment by its unique ID.
+                EOT,
                 auth: [AuthType::KEY],
                 responses: [
                     new SDKResponse(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Download/Get.php b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Download/Get.php
index e216989dd1..8e1235c5ee 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Download/Get.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Download/Get.php
@@ -3,6 +3,11 @@
 namespace Appwrite\Platform\Modules\Sites\Http\Deployments\Download;
 
 use Appwrite\Extend\Exception;
+use Appwrite\SDK\AuthType;
+use Appwrite\SDK\ContentType;
+use Appwrite\SDK\Method;
+use Appwrite\SDK\MethodType;
+use Appwrite\SDK\Response as SDKResponse;
 use Appwrite\Utopia\Response;
 use Utopia\Database\Database;
 use Utopia\Database\Validator\UID;
@@ -28,13 +33,22 @@ class Get extends Action
             ->desc('Download deployment')
             ->groups(['api', 'sites'])
             ->label('scope', 'sites.read')
-            ->label('sdk.auth', [APP_AUTH_TYPE_KEY, APP_AUTH_TYPE_JWT])
-            ->label('sdk.namespace', 'sites')
-            ->label('sdk.method', 'getDeploymentDownload')
-            ->label('sdk.description', '/docs/references/sites/get-deployment-download.md')
-            ->label('sdk.response.code', Response::STATUS_CODE_OK)
-            ->label('sdk.response.type', '*/*')
-            ->label('sdk.methodType', 'location')
+            ->label('sdk', new Method(
+                namespace: 'sites',
+                name: 'getDeploymentDownload',
+                description: <<<EOT
+                Get a site deployment content by its unique ID. The endpoint response return with a 'Content-Disposition: attachment' header that tells the browser to start downloading the file to user downloads directory.
+                EOT,
+                auth: [AuthType::KEY, AuthType::JWT],
+                responses: [
+                    new SDKResponse(
+                        code: Response::STATUS_CODE_OK,
+                        model: Response::MODEL_NONE
+                    )
+                ],
+                type: MethodType::LOCATION,
+                contentType: ContentType::ANY,
+            ))
             ->param('siteId', '', new UID(), 'Site ID.')
             ->param('deploymentId', '', new UID(), 'Deployment ID.')
             ->inject('response')
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Get.php b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Get.php
index 575a1b0769..3864fdcac6 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Get.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Get.php
@@ -35,7 +35,9 @@ class Get extends Action
             ->label('sdk', new Method(
                 namespace: 'sites',
                 name: 'getDeployment',
-                description: '/docs/references/sites/get-deployment.md',
+                description: <<<EOT
+                Get a site deployment by its unique ID.
+                EOT,
                 auth: [AuthType::KEY],
                 responses: [
                     new SDKResponse(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Update.php b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Update.php
index c994cd14e6..9e1c516956 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Update.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Update.php
@@ -37,7 +37,9 @@ class Update extends Action
             ->label('sdk', new Method(
                 namespace: 'sites',
                 name: 'updateDeployment',
-                description: '/docs/references/sites/update-deployment.md',
+                description: <<<EOT
+                Update the site active deployment. Use this endpoint to switch the code deployment that should be used when visitor opens your site.
+                EOT,
                 auth: [AuthType::KEY],
                 responses: [
                     new SDKResponse(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/XList.php b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/XList.php
index fab3db3cba..8a79561e2b 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/XList.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/XList.php
@@ -39,7 +39,9 @@ class XList extends Action
             ->label('sdk', new Method(
                 namespace: 'sites',
                 name: 'listDeployments',
-                description: '/docs/references/sites/list-deployments.md',
+                description: <<<EOT
+                Get a list of all the site's code deployments. You can use the query params to filter your results.
+                EOT,
                 auth: [AuthType::KEY],
                 responses: [
                     new SDKResponse(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Frameworks/XList.php b/src/Appwrite/Platform/Modules/Sites/Http/Frameworks/XList.php
index 1afdbdcc12..09075b53cb 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Frameworks/XList.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Frameworks/XList.php
@@ -33,7 +33,9 @@ class XList extends Base
             ->label('sdk', new Method(
                 namespace: 'sites',
                 name: 'listFrameworks',
-                description: '/docs/references/sites/list-frameworks.md',
+                description: <<<EOT
+                Get a list of all frameworks that are currently available on the server instance.
+                EOT,
                 auth: [AuthType::KEY],
                 responses: [
                     new SDKResponse(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Logs/Delete.php b/src/Appwrite/Platform/Modules/Sites/Http/Logs/Delete.php
index 2b8a0c9113..da13984adc 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Logs/Delete.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Logs/Delete.php
@@ -38,7 +38,9 @@ class Delete extends Base
             ->label('sdk', new Method(
                 namespace: 'sites',
                 name: 'deleteLog',
-                description: '/docs/references/sites/delete-log.md',
+                description: <<<EOT
+                Delete a site log by its unique ID.
+                EOT,
                 auth: [AuthType::KEY],
                 responses: [
                     new SDKResponse(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Logs/Get.php b/src/Appwrite/Platform/Modules/Sites/Http/Logs/Get.php
index e2f4363311..0dddeef7c0 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Logs/Get.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Logs/Get.php
@@ -33,7 +33,9 @@ class Get extends Base
             ->label('sdk', new Method(
                 namespace: 'sites',
                 name: 'getLog',
-                description: '/docs/references/sites/get-log.md',
+                description: <<<EOT
+                Get a site request log by its unique ID.
+                EOT,
                 auth: [AuthType::KEY],
                 responses: [
                     new SDKResponse(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Logs/XList.php b/src/Appwrite/Platform/Modules/Sites/Http/Logs/XList.php
index c84428822a..134978d8b9 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Logs/XList.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Logs/XList.php
@@ -41,7 +41,9 @@ class XList extends Base
             ->label('sdk', new Method(
                 namespace: 'sites',
                 name: 'listLogs',
-                description: '/docs/references/sites/get-log.md',
+                description: <<<EOT
+                Get a list of all site logs. You can use the query params to filter your results.
+                EOT,
                 auth: [AuthType::KEY],
                 responses: [
                     new SDKResponse(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Sites/Create.php b/src/Appwrite/Platform/Modules/Sites/Http/Sites/Create.php
index 5d3e162af0..2f21bfd24e 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Sites/Create.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Sites/Create.php
@@ -55,7 +55,9 @@ class Create extends Base
             ->label('sdk', new Method(
                 namespace: 'site',
                 name: 'create',
-                description: '/docs/references/sites/create.md',
+                description: <<<EOT
+                Create a new site.
+                EOT,
                 auth: [AuthType::KEY],
                 responses: [
                     new SDKResponse(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Sites/Delete.php b/src/Appwrite/Platform/Modules/Sites/Http/Sites/Delete.php
index 4ceb9b744c..52c39c0e0f 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Sites/Delete.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Sites/Delete.php
@@ -39,7 +39,9 @@ class Delete extends Base
             ->label('sdk', new Method(
                 namespace: 'sites',
                 name: 'delete',
-                description: '/docs/references/sites/delete.md',
+                description: <<<EOT
+                Delete a site by its unique ID.
+                EOT,
                 auth: [AuthType::KEY],
                 responses: [
                     new SDKResponse(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Sites/Get.php b/src/Appwrite/Platform/Modules/Sites/Http/Sites/Get.php
index c685fccfaf..103ab3f751 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Sites/Get.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Sites/Get.php
@@ -34,7 +34,9 @@ class Get extends Base
             ->label('sdk', new Method(
                 namespace: 'sites',
                 name: 'get',
-                description: '/docs/references/sites/get.md',
+                description: <<<EOT
+                Get a site by its unique ID.
+                EOT,
                 auth: [AuthType::KEY],
                 responses: [
                     new SDKResponse(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Sites/Update.php b/src/Appwrite/Platform/Modules/Sites/Http/Sites/Update.php
index 6a2bc00b1b..578e0cf164 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Sites/Update.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Sites/Update.php
@@ -53,7 +53,9 @@ class Update extends Base
             ->label('sdk', new Method(
                 namespace: 'sites',
                 name: 'update',
-                description: '/docs/references/sites/update.md',
+                description: <<<EOT
+                Update site by its unique ID.
+                EOT,
                 auth: [AuthType::KEY],
                 responses: [
                     new SDKResponse(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Sites/XList.php b/src/Appwrite/Platform/Modules/Sites/Http/Sites/XList.php
index 08d4adb474..35fef542c0 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Sites/XList.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Sites/XList.php
@@ -38,7 +38,9 @@ class XList extends Base
             ->label('sdk', new Method(
                 namespace: 'sites',
                 name: 'list',
-                description: '/docs/references/sites/list.md',
+                description: <<<EOT
+                Get a list of all the project's sites. You can use the query params to filter your results.
+                EOT,
                 auth: [AuthType::KEY],
                 responses: [
                     new SDKResponse(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Templates/Get.php b/src/Appwrite/Platform/Modules/Sites/Http/Templates/Get.php
index 31e54070d2..977bfe7fd1 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Templates/Get.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Templates/Get.php
@@ -34,7 +34,9 @@ class Get extends Base
             ->label('sdk', new Method(
                 namespace: 'sites',
                 name: 'getTemplate',
-                description: '/docs/references/sites/get-template.md',
+                description: <<<EOT
+                Get a site template using ID. You can use template details in [createSite](/docs/references/cloud/server-nodejs/sites#create) method.
+                EOT,
                 auth: [AuthType::ADMIN],
                 responses: [
                     new SDKResponse(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Templates/XList.php b/src/Appwrite/Platform/Modules/Sites/Http/Templates/XList.php
index f5cc762445..277cc2c615 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Templates/XList.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Templates/XList.php
@@ -35,7 +35,9 @@ class XList extends Base
             ->label('sdk', new Method(
                 namespace: 'sites',
                 name: 'listTemplates',
-                description: '/docs/references/sites/list-templates.md',
+                description: <<<EOT
+                List available site templates. You can use template details in [createSite](/docs/references/cloud/server-nodejs/sites#create) method.
+                EOT,
                 auth: [AuthType::ADMIN],
                 responses: [
                     new SDKResponse(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Usage/Get.php b/src/Appwrite/Platform/Modules/Sites/Http/Usage/Get.php
index 6365d59f6f..83b92e701a 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Usage/Get.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Usage/Get.php
@@ -38,7 +38,9 @@ class Get extends Base
             ->label('sdk', new Method(
                 namespace: 'sites',
                 name: 'getUsage',
-                description: '/docs/references/sites/get-usage.md',
+                description: <<<EOT
+                Get usage metrics and statistics for a for a specific site. View statistics including total deployments, builds, executions, storage usage, and compute time. The response includes both current totals and historical data for each metric. Use the optional range parameter to specify the time window for historical data: 24h (last 24 hours), 30d (last 30 days), or 90d (last 90 days). If not specified, defaults to 30 days.
+                EOT,
                 auth: [AuthType::ADMIN],
                 responses: [
                     new SDKResponse(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Usage/XList.php b/src/Appwrite/Platform/Modules/Sites/Http/Usage/XList.php
index 1c8991d4b2..225b6cb7a7 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Usage/XList.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Usage/XList.php
@@ -36,7 +36,9 @@ class XList extends Base
             ->label('sdk', new Method(
                 namespace: 'sites',
                 name: 'listUsage',
-                description: '/docs/references/sites/list-usage.md',
+                description: <<<EOT
+                Get usage metrics and statistics for all sites in the project. View statistics including total deployments, builds, logs, storage usage, and compute time. The response includes both current totals and historical data for each metric. Use the optional range parameter to specify the time window for historical data: 24h (last 24 hours), 30d (last 30 days), or 90d (last 90 days). If not specified, defaults to 30 days.
+                EOT,
                 auth: [AuthType::ADMIN],
                 responses: [
                     new SDKResponse(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Variables/Create.php b/src/Appwrite/Platform/Modules/Sites/Http/Variables/Create.php
index 21d4452f13..1207f6c1c4 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Variables/Create.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Variables/Create.php
@@ -42,7 +42,9 @@ class Create extends Base
             ->label('sdk', new Method(
                 namespace: 'sites',
                 name: 'createVariable',
-                description: '/docs/references/sites/create-variable.md',
+                description: <<<EOT
+                Create a new site variable. These variables can be accessed during build and runtime (server-side rendering) as environment variables.
+                EOT,
                 auth: [AuthType::KEY],
                 responses: [
                     new SDKResponse(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Variables/Delete.php b/src/Appwrite/Platform/Modules/Sites/Http/Variables/Delete.php
index bbea1a7611..461bcdfdd9 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Variables/Delete.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Variables/Delete.php
@@ -36,7 +36,9 @@ class Delete extends Base
             ->label('sdk', new Method(
                 namespace: 'sites',
                 name: 'deleteVariable',
-                description: '/docs/references/sites/delete-variable.md',
+                description: <<<EOT
+                Delete a variable by its unique ID.
+                EOT,
                 auth: [AuthType::KEY],
                 responses: [
                     new SDKResponse(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Variables/Get.php b/src/Appwrite/Platform/Modules/Sites/Http/Variables/Get.php
index edde40a2aa..ca5ad09663 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Variables/Get.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Variables/Get.php
@@ -35,7 +35,9 @@ class Get extends Base
                 new Method(
                     namespace: 'sites',
                     name: 'getVariable',
-                    description: '/docs/references/sites/get-variable.md',
+                    description: <<<EOT
+                    Get a variable by its unique ID.
+                    EOT,
                     auth: [AuthType::KEY],
                     responses: [
                         new SDKResponse(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Variables/Update.php b/src/Appwrite/Platform/Modules/Sites/Http/Variables/Update.php
index 4c7ad023d6..d9d70e4bdf 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Variables/Update.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Variables/Update.php
@@ -37,7 +37,9 @@ class Update extends Base
             ->label('sdk', new Method(
                 namespace: 'sites',
                 name: 'updateVariable',
-                description: '/docs/references/sites/update-variable.md',
+                description: <<<EOT
+                Update variable by its unique ID.
+                EOT,
                 auth: [AuthType::KEY],
                 responses: [
                     new SDKResponse(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Variables/XList.php b/src/Appwrite/Platform/Modules/Sites/Http/Variables/XList.php
index 3c48de949a..9bb887eb26 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Variables/XList.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Variables/XList.php
@@ -36,7 +36,9 @@ class XList extends Base
                 new Method(
                     namespace: 'sites',
                     name: 'listVariables',
-                    description: '/docs/references/sites/list-variables.md',
+                    description: <<<EOT
+                    Get a list of all variables of a specific site.
+                    EOT,
                     auth: [AuthType::KEY],
                     responses: [
                         new SDKResponse(
diff --git a/src/Appwrite/SDK/Method.php b/src/Appwrite/SDK/Method.php
index 626459ea7f..708d5c5dc0 100644
--- a/src/Appwrite/SDK/Method.php
+++ b/src/Appwrite/SDK/Method.php
@@ -87,11 +87,13 @@ class Method
             return;
         }
 
-        $descPath = $this->getDescriptionFilePath();
+        if(\str_ends_with($desc, '.md')) {
+            $descPath = $this->getDescriptionFilePath();
 
-        if (empty($descPath)) {
-            self::$errors[] = "Error with {$this->getRouteName()} method: Description file not found at {$desc}";
-            return;
+            if (empty($descPath)) {
+                self::$errors[] = "Error with {$this->getRouteName()} method: Description file not found at {$desc}";
+                return;
+            }
         }
     }
 
diff --git a/src/Appwrite/Specification/Format/OpenAPI3.php b/src/Appwrite/Specification/Format/OpenAPI3.php
index bd5405539d..e60d342b0b 100644
--- a/src/Appwrite/Specification/Format/OpenAPI3.php
+++ b/src/Appwrite/Specification/Format/OpenAPI3.php
@@ -177,11 +177,14 @@ class OpenAPI3 extends Format
 
             $namespace = $sdk->getNamespace() ?? 'default';
 
+            $desc = $desc ?? '';
+            $descContents = \str_ends_with($desc, '.md') ? \file_get_contents($desc) : $desc;
+
             $temp = [
                 'summary' => $route->getDesc(),
                 'operationId' => $namespace . ucfirst($method),
                 'tags' => [$namespace],
-                'description' => ($desc) ? \file_get_contents($desc) : '',
+                'description' => $descContents,
                 'responses' => [],
                 'x-appwrite' => [ // Appwrite related metadata
                     'method' => $method,
diff --git a/src/Appwrite/Specification/Format/Swagger2.php b/src/Appwrite/Specification/Format/Swagger2.php
index 7277e3ab2b..fae164f0a6 100644
--- a/src/Appwrite/Specification/Format/Swagger2.php
+++ b/src/Appwrite/Specification/Format/Swagger2.php
@@ -173,13 +173,16 @@ class Swagger2 extends Format
 
             $namespace = $sdk->getNamespace() ?? 'default';
 
+            $desc = $desc ?? '';
+            $descContents = \str_ends_with($desc, '.md') ? \file_get_contents($desc) : $desc;
+
             $temp = [
                 'summary' => $route->getDesc(),
                 'operationId' => $namespace . ucfirst($method),
                 'consumes' => [],
                 'produces' => [],
                 'tags' => [$namespace],
-                'description' => ($desc) ? \file_get_contents($desc) : '',
+                'description' => $descContents,
                 'responses' => [],
                 'x-appwrite' => [ // Appwrite related metadata
                     'method' => $method,