Add descriptions

app/controllers/api/messaging.php

@@ -145,7 +145,7 @@ App::post('/v1/messaging/providers/sendgrid')
     ->label('sdk.auth', [APP_AUTH_TYPE_ADMIN, APP_AUTH_TYPE_KEY])
     ->label('sdk.namespace', 'messaging')
     ->label('sdk.method', 'createSendgridProvider')
-    ->label('sdk.description', '/docs/references/messaging/create-sengrid-provider.md')
+    ->label('sdk.description', '/docs/references/messaging/create-sendgrid-provider.md')
     ->label('sdk.response.code', Response::STATUS_CODE_CREATED)
     ->label('sdk.response.type', Response::CONTENT_TYPE_JSON)
     ->label('sdk.response.model', Response::MODEL_PROVIDER)

app/controllers/api/migrations.php

@@ -1038,7 +1038,7 @@ App::delete('/v1/migrations/:migrationId')
     ->label('sdk.auth', [APP_AUTH_TYPE_ADMIN])
     ->label('sdk.namespace', 'migrations')
     ->label('sdk.method', 'delete')
-    ->label('sdk.description', '/docs/references/functions/delete-migration.md')
+    ->label('sdk.description', '/docs/references/migrations/delete-migration.md')
     ->label('sdk.response.code', Response::STATUS_CODE_NOCONTENT)
     ->label('sdk.response.model', Response::MODEL_NONE)
     ->param('migrationId', '', new UID(), 'Migration ID.')

docs/references/account/add-authenticator.md

@@ -0,0 +1 @@
+Add an authenticator app to be used as an MFA factor. Verify the authenticator using the [verify authenticator](/docs/references/cloud/client-web/account#verifyAuthenticator) method.

docs/references/account/create-2fa-challenge.md

@@ -0,0 +1 @@
+Initialize an MFA challenge of the specified factor. The factor must be available on the account.

docs/references/account/delete-mfa.md

@@ -0,0 +1 @@
+Delete an authenticator for a user by ID.

docs/references/account/list-factors.md

@@ -0,0 +1 @@
+List the factors available on the account to be used as a MFA challange.

docs/references/account/update-challenge.md

@@ -0,0 +1 @@
+Complete the MFA challenge by providing the one-time password.

docs/references/account/update-mfa.md

@@ -0,0 +1 @@
+Enable or disable MFA on an account.

docs/references/account/verify-authenticator.md

@@ -0,0 +1 @@
+Verify an authenticator app after adding it using the [add authenticator](/docs/references/cloud/client-web/account#addAuthenticator) method.

docs/references/databases/create-attribute-enum.md

@@ -0,0 +1 @@
+Create an enumeration attribute. The `elements` param acts as a white-list of accepted values for this attribute. 

docs/references/databases/create-datetime-attribute.md

@@ -0,0 +1 @@
+Create a date time attribute according to the ISO 8601 standard.

docs/references/databases/create-index.md

@@ -0,0 +1,2 @@
+Creates an index on the attributes listed. Your index should include all the attributes you will query in a single request.
+Attributes can be `key`, `fulltext`, and `unique`.

docs/references/databases/delete-attribute.md

@@ -0,0 +1 @@
+Deletes an attribute.

docs/references/databases/delete-index.md

@@ -0,0 +1 @@
+Delete an index.

docs/references/databases/get-attribute.md

@@ -0,0 +1 @@
+Get attribute by ID.

docs/references/databases/get-index.md

@@ -0,0 +1 @@
+Get index by ID.

docs/references/databases/list-attributes.md

@@ -0,0 +1 @@
+List attributes in the collection.

docs/references/databases/list-indexes.md

@@ -0,0 +1 @@
+List indexes in the collection.

docs/references/databases/update-boolean-attribute.md

@@ -0,0 +1 @@
+Update a boolean attribute. Changing the `default` value will not update already existing documents.

docs/references/databases/update-datetime-attribute.md

@@ -0,0 +1 @@
+Update a date time attribute. Changing the `default` value will not update already existing documents.

docs/references/health/get-queue-functions.md

@@ -0,0 +1 @@
+Get the number of function executions that are waiting to be processed in the Appwrite internal queue server.

docs/references/messaging/delete-message.md

@@ -0,0 +1 @@
+Delete a message. If the message is not a draft or scheduled, but has been sent, this will not recall the message.

docs/references/users/create-target.md

@@ -0,0 +1 @@
+Create a messaging target.

docs/references/users/delete-mfa.md

@@ -0,0 +1 @@
+Delete an authenticator app.

docs/references/users/delete-target.md

@@ -0,0 +1 @@
+Delete a messaging target.

docs/references/users/get-user-target.md

@@ -0,0 +1 @@
+Get a user's push notification target by ID.

docs/references/users/list-factors.md

@@ -0,0 +1 @@
+List the factors available on the account to be used as a MFA challange.

docs/references/users/list-user-targets.md

@@ -0,0 +1 @@
+List the messaging targets that are associated with a user.

docs/references/users/update-target.md

@@ -0,0 +1 @@
+Update a messaging target.

docs/references/users/update-user-mfa.md

@@ -0,0 +1 @@
+Enable or disable MFA on a user account.

package-lock.json

@@ -0,0 +1,10 @@
+{
+  "name": "@appwrite.io/repo",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "@appwrite.io/repo"
+    }
+  }
+}

src/Appwrite/Specification/Format/Swagger2.php

@@ -122,6 +122,10 @@ class Swagger2 extends Format
 
             $method = $route->getLabel('sdk.method', \uniqid());
             $desc = (!empty($route->getLabel('sdk.description', ''))) ? \realpath(__DIR__ . '/../../../../' . $route->getLabel('sdk.description', '')) : null;
+            if ($desc == null){
+                echo $route->getLabel('sdk.description', '');
+                echo '';
+            }
             $produces = $route->getLabel('sdk.response.type', null);
             $model = $route->getLabel('sdk.response.model', 'none');
             $routeSecurity = $route->getLabel('sdk.auth', []);