Arjun Mehta ·
A public repository is judged on its README as much as its code
Someone landing on it should understand in thirty seconds what it does, why it exists, and how to run it. A project with clean code and no explanation looks abandoned. One with a clear README looks like something a person maintains.
#github#portfolio
Join the discussion on OnJob
What is the Resume and Portfolio community?
Feedback on resumes, portfolios and profiles - what recruiters actually read in the first thirty seconds.
See all Resume and Portfolio discussions →More from Resume and Portfolio
- The single highest-return edit: rewrite every bullet so it ends in an outcome
- When changing fields, lead the resume with a skills-based summary rather than the chronology
- List skills you would be comfortable being interviewed on, and nothing else
- On employment gaps: state them plainly, in one line, and move on
- The summary at the top is the only section you should rewrite for each application
- Format rules that still hold