Lab 3 — Troubleshooting & Debugging Exercise Objective This lab simulates real-world debugging scenarios where engineers must understand, fix, and execute unfamiliar codebases. You will be assessed on your problem-solving process , not just the final result. Technical Requirements
- Fork the provided GitHub repository
- Clone your fork locally
- Attempt to run the application
- Identify:
○ Runtime errors
○ Syntax errors
○ Dependency issues
○ Environment mismatches
Expected Debugging Actions
● Read error messages carefully
● Modify code incrementally
● Install missing dependencies if needed
● Fix:
○ Incorrect imports
○ Logic errors
○ Version mismatches
You may not rewrite the project entirely — the goal is targeted fixes.
Documentation Requirements
You must document:
● Initial error(s) encountered
● Steps taken to diagnose
● Code changes made
● Final successful execution
This may be included in:
● README.md
● Separate DEBUGGING.md file
Deliverables
● Link to your forked repository
● Updated, runnable code
● Written troubleshooting explanation
Evaluation Criteria
Area
Correct execution
Debugging documentation Quality of fixes
Commit clarity
Weight 40% 30% 20% 10%