docs: Improve Swagger JSDoc

2025-12-22 09:15:37 +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/tasks/create.js
+++ b/server/api/controllers/tasks/create.js
@@ -11,6 +11,7 @@
 *     description: Creates a task within a task list. Either `linkedCardId` or `name` must be provided. Requires board editor permissions.
 *     tags:
 *       - Tasks
+ *     operationId: createTask
 *     parameters:
 *       - name: taskListId
 *         in: path
--- a/server/api/controllers/tasks/delete.js
+++ b/server/api/controllers/tasks/delete.js
@@ -11,6 +11,7 @@
 *     description: Deletes a task. Requires board editor permissions.
 *     tags:
 *       - Tasks
+ *     operationId: deleteTask
 *     parameters:
 *       - name: id
 *         in: path
--- a/server/api/controllers/tasks/update.js
+++ b/server/api/controllers/tasks/update.js
@@ -11,6 +11,7 @@
 *     description: Updates a task. Linked card tasks have limited update options. Requires board editor permissions.
 *     tags:
 *       - Tasks
+ *     operationId: updateTask
 *     parameters:
 *       - name: id
 *         in: path