How to Stand Out With Your GitHub Profile

#growth #github #webdev #beginners

GitHub recently released a new feature that is still quite hidden, but that can really help you stand out when you're searching for work as a developer. You can now create a README file that features front and center on your GitHub profile. Your personal documentation, if you will.

kathy ☁️

@pifafu

hey, so we heard ya & are trying out a thing where you CAN have a readme on your @github profile...
@mikekavouras built it btw! re: twitter.com/pifafu/status/…

22:33 PM - 27 May 2020

kathy ☁️ @pifafu
👋 hiii—if you use @github, i was wondering: what are some of the things you would want others on GitHub to know about you?

1134 6314

The README is placed above your pinned repositories, where it takes up quite a bit of space. It's the first thing people will see when they're visiting your profile, so you want to make sure it's as compelling as possible.

I believe that this will quickly become an incredibly important feature. Arguably more important than your LinkedIn profile, because a GitHub profile is much more flexible and can really show off your creativity, your personality, and your capabilities on what's increasingly the most important platform for developers.

Rubens Mariuzzo's profile

How to Create a Great GitHub Profile

Before we read, we skim. That's why it's important to keep your GitHub README short and neatly organized. I like Rubens' profile shown above, because it's six bullet points that are all easy to digest.

But each bullet point has links if you want to dive deeper. You want to link to your best GitHub code samples and articles. That's right, articles too. A developer who can communicate clearly through writing is a better developer. This is particularly true for remote developers (and aren't we all remote these days?). So if you have a blog, link it!

Alternatively, if you don't have a blog, talk about the projects you helped build. What was your contribution to them? Which challenges did you overcome? What did you learn?

I emphasize this because an experienced developer is much more than just a good programmer. An experienced developer knows how to give constructive feedback, how to conduct a great code review, how to immediately add value to a team, etc. So show your soft skills in your profile too.

Finally, be creative! Your profile doesn't and shouldn't be a copy of your LinkedIn page. Experiment with images, GIFs, emojis, SVGs, format, and font. The trick is to find the right balance between informative and creative. Thankfully, there are already many creative GitHub profiles out there.

A Few Creative GitHub Profiles

Simple, But Solid

Milly Rodriguez' profile is short and sharp. It shows off her personality as well as her creativity. This is a great profile that you can use as a template to impress other developers.

The same goes for Claudia R. Her profile has a nice banner and good information about what she does and how you can contact her. The GIF, the images, and the smileys make her profile appealing to read.

To give you an idea of the depth you can put into your profile, check out the profile of X-Team's CEO Ryan Chartrand. There's a catchy banner, a brief introduction, some highlights in his career, and what it's like working with him.

Another excellent example is Beto Muniz's profile. He clearly describes who he is, who he works for, how you can contact him, the technologies he knows, and also what personal projects he's working on.

A Self-Updating Profile

Simon Willison uses a GitHub Action to automatically keep his profile up-to-date. His README file has three columns: one with the projects he's working on, another with his blog posts, and a third column with his TILs. These are automatically added to his profile as he publishes them on their respective platforms.

CSS Animations

Jhey Tompkins' profile shows the versatility of GitHub profiles. He uses a CSS animation inlined within an SVG that's only 35kb big. Compare that to a GIF that's several megabytes in size.