docs: Improve Swagger JSDoc

server/api/controllers/board-memberships/create.js

@@ -7,15 +7,16 @@
  * @swagger
  * /boards/{boardId}/memberships:
  *   post:
- *     summary: Add user to board
- *     description: Adds a user to a board. Requires project manager permissions.
+ *     summary: Create board membership
+ *     description: Creates a board membership within a board. Requires project manager permissions.
  *     tags:
  *       - Board Memberships
+ *     operationId: createBoardMembership
  *     parameters:
  *       - name: boardId
  *         in: path
  *         required: true
- *         description: ID of the board to add the user to
+ *         description: ID of the board to create the board membership in
  *         schema:
  *           type: string
  *           example: "1357158568008091264"
@@ -31,7 +32,7 @@
  *             properties:
  *               userId:
  *                 type: string
- *                 description: ID of the user to add to the board
+ *                 description: ID of the user who is a member of the board
  *                 example: "1357158568008091265"
  *               role:
  *                 type: string
@@ -45,7 +46,7 @@
  *                 example: true
  *     responses:
  *       200:
- *         description: User added to board successfully
+ *         description: Board membership created successfully
  *         content:
  *           application/json:
  *             schema:

server/api/controllers/board-memberships/delete.js

@@ -7,21 +7,22 @@
  * @swagger
  * /board-memberships/{id}:
  *   delete:
- *     summary: Remove user from board
- *     description: Removes a user from a board. Users can remove themselves, or project managers can remove any user.
+ *     summary: Delete board membership
+ *     description: Deletes a board membership. Users can remove their own membership, project managers can remove any membership.
  *     tags:
  *       - Board Memberships
+ *     operationId: deleteBoardMembership
  *     parameters:
  *       - name: id
  *         in: path
  *         required: true
- *         description: ID of the board membership to remove
+ *         description: ID of the board membership to delete
  *         schema:
  *           type: string
  *           example: "1357158568008091264"
  *     responses:
  *       200:
- *         description: User removed from board successfully
+ *         description: Board membership deleted successfully
  *         content:
  *           application/json:
  *             schema:

server/api/controllers/board-memberships/update.js

@@ -11,6 +11,7 @@
  *     description: Updates a board membership. Requires project manager permissions.
  *     tags:
  *       - Board Memberships
+ *     operationId: updateBoardMembership
  *     parameters:
  *       - name: id
  *         in: path