• Posts
  • RSS
  • ◂◂RSS
  • Contact

  • GitHub Resumes

    October 20th, 2016
    tech
    In software hiring it's becoming somewhat common for people to look at your public open source code to help make the decision. This tends to be described as "your resume is now GitHub". [1] And you see people offering advice like:
    The problem is that while most programmers seem to understand and even embrace GitHub as the new resume, few if any seem to have actually put any thought or time into making their GitHub accounts look and work well as such.

    GitHub is more than just your social backup storage, it's your portfolio and it's public. You can't just dump everything there willy-nilly or your account is going to look like shit, which it probably does.

    And suggesting things like:
    The work you did a year or more ago couldn't possibly still be relevant today. If it is, you aren't working hard enough or learning fast enough. Get rid of anything you haven't worked on in over a year.
    This advice makes a lot of sense: if employers are looking at your GitHub account to evaluate you, and you can choose what to show them, you're most likely to get hired if you put a careful selection of work up. But the consequences of this are terrible! The more people follow this, the less useful-but-ugly code there is out there for others to learn from or adapt.

    For example, take my draw_heatmap.py. It is not good code. It's slow, not especially well structured, and not very easy for people to understand. I wrote it in a hurry, when I had an idea to make a map of Boston rents. I could have just shown off the pretty map, but I put the code up in case others were interested. Various people ended up running it for their own cities, which I wasn't expecting, but which I'm very glad they did. If I wanted to make my GitHub page contain only work that reflected very well on me, though, it wouldn't be up there.

    I know how to write good code, but it takes longer, and if I'm writing something exploratory with a primary audience of myself I'll generally prioritize just getting it done. I think this is pretty reasonable, appropriate for those situations, and I'd like code written in this manner to still be available for people to look through. When employers pass up people with messy GitHub profiles, however, they are hurting the norm that you open source as much as possible. I wish they would consume transparency more responsibly.

    (My day job is working on an open source project, which means that most of my GitHub activity actually does (I think) look pretty good. It's professional stuff, written within an organization that values and supports code quality. Someone who wants to see whether I can write good code can get lots of nice examples, so the GitHub-resume system isn't all bad for me.)


    [1] There are other problems with using open source code as a guide when hiring, like people with kids being way less likely to have the time for side projects to put up, and so decreasing the diversity of your hiring pool. I'm not trying to get into this here.

    Comment via: google plus, facebook

    Recent posts on blogs I like:

    Moral aesthetics

    “Doing good” differs by subculture The post Moral aesthetics appeared first on Otherwise.

    via Otherwise September 29, 2022

    Futurist prediction methods and accuracy

    I've been reading a lot of predictions from people who are looking to understand what problems humanity will face 10-50 years out (and sometimes longer) in order to work in areas that will be instrumental for the future and wondering how accurate thes…

    via Posts on September 12, 2022

    On the Beach

    I really like going in the water and this beach is a great place for building sand castles and boogie boarding. I also like trying to float on top of big waves. I'm not very good at it. I only float on the flat waves.

    via Anna Wise's Blog Posts July 12, 2022

    more     (via openring)


  • Posts
  • RSS
  • ◂◂RSS
  • Contact