2025-01-22 · careers, portfolio
Portfolio READMEs That Hiring Managers Actually Open
Hiring managers skim dozens of repositories. The README is the cover letter. We coach learners to lead with the problem statement, dataset provenance, and evaluation metrics — including where the model fails.
A strong README includes: how to run the project in under ten minutes, hardware assumptions, a limitations section, and a short "what I would do next" paragraph. Screenshots are optional; confusion matrices and error analysis tables are better.
We discourage listing every library installed. Instead, link to a requirements file and explain one non-obvious dependency choice. For bilingual applicants in Japan, an English README with a short Japanese summary is welcome but not required.
This article accompanies exercises in the Portfolio Review Intensive; it is not a substitute for personalized feedback on your repo.