docs: add request/response example objects as requested by reviewer

Author: Shreenath-14

backend/routes/authRoutes.js

@@ -17,20 +17,28 @@ const authRoutes = express.Router();
  *         application/json:
  *           schema:
  *             type: object
- *             required:
- *               - name
- *               - email
- *               - password
+ *             required: [name, email, password]
  *             properties:
  *               name:
  *                 type: string
+ *                 example: "John Doe"
  *               email:
  *                 type: string
+ *                 example: "john@example.com"
  *               password:
  *                 type: string
- *             responses:
- *               201:
- *                 description: User registered successfully
+ *                 example: "StrongPass123!"
+ *     responses:
+ *       201:
+ *         description: User registered successfully
+ *         content:
+ *           application/json:
+ *             schema:
+ *               type: object
+ *               properties:
+ *                 message:
+ *                   type: string
+ *                   example: "User registered successfully"
  */
 authRoutes.post("/registration", validateRequest(registerSchema), registration);
 
@@ -46,17 +54,25 @@ authRoutes.post("/registration", validateRequest(registerSchema), registration);
  *         application/json:
  *           schema:
  *             type: object
- *             required:
- *               - email
- *               - password
+ *             required: [email, password]
  *             properties:
  *               email:
  *                 type: string
+ *                 example: "john@example.com"
  *               password:
  *                 type: string
- *             responses:
- *               200:
- *                 description: Login successful
+ *                 example: "StrongPass123!"
+ *     responses:
+ *       200:
+ *         description: Login successful
+ *         content:
+ *           application/json:
+ *             schema:
+ *               type: object
+ *               properties:
+ *                 token:
+ *                   type: string
+ *                   example: "eyJhbGciOiJIUzI1Ni..."
  */
 authRoutes.post("/login", validateRequest(loginSchema), login);