docs: Improve Swagger JSDoc

2025-12-20 01:14:12 +03:00 · 2025-09-12 12:17:01 +02:00
parent 494800d131
commit b4979d214f
129 changed files with 294 additions and 248 deletions
--- a/server/api/controllers/users/update.js
+++ b/server/api/controllers/users/update.js
@@ -11,6 +11,7 @@
 *     description: Updates a user. Users can update their own profile, admins can update any user.
 *     tags:
 *       - Users
+ *     operationId: updateUser
 *     parameters:
 *       - name: id
 *         in: path
@@ -40,6 +41,7 @@
 *                 type: object
 *                 nullable: true
 *                 description: Avatar of the user (only null value to remove avatar)
+ *                 example: null
 *               phone:
 *                 type: string
 *                 maxLength: 128