Domain: Documentation
Difficulty: Beginner
Description:
The README.md in the API folder lacks detailed endpoint documentation. Add a comprehensive API section documenting:
- All available endpoints (GET, POST, etc.)
- URL paths and query parameters
- Example requests and responses
- Required vs optional parameters
- Error response formats
- Base URL information
Example format:
### GET /actors/search Search for actors by name - Query Parameters: `name` (required, string) - Example: `/actors/search?name=Tom Hanks` - Response: Array of actor objects with id, label, description, and imageUrl
Expected Outcome:
- Complete API documentation in README.md
- Frontend developers can understand API contracts
- Clear parameter and response formats documented
- Example curl commands for each endpoint
Setup Steps:
Clone code
- Open src/server.js to identify all routes
- Open README.md.
- Add section: "## API Endpoints."
- Document each endpoint from:
- /actors routes
- /productions routes
- /collaborators routes
- Include example requests and responses
- Add parameter descriptions
Links/References:
- File: README.md
- Routes defined in:
- src/routers/actorsRoutes.ts
- src/routers/productionRouters.ts
- src/routers/collaborationRouters.ts