DEV Community

Yordan Ivanov
Yordan Ivanov

Posted on • Originally published at ivanovyordan.com on

QuickTip: GitHub profile readme

GitHub is important for your career. You know It’s like your public portfolio. The question is how to make it stand out? Luckily, GitHub released a pretty cool feature, and in this quick tip, we will see how to use it.

So, as we already said, GitHub recently released a new feature that can make your profile stand out, or at least look a bit more personalized. All you need to do is to create a profile-level READMEfile, and GitHub will display it on top of your page.

Why README

We all know how important READMEs are for documenting every project. It’s often the border between working alone and finding contributors. I think using README for documenting people is a great idea.

But why do we need README when we can just write a short bio? Well, Markdown is more flexible - we can place links, images, or even GIFs. README also takes more space in the centre of peoples screens. With all that freedom and space awesome people can make awesome things.

How-To

Enough talking, let’s see how to beautify our profiles. It’s fast, and you can do it in three easy steps:

  1. Go to https://github.com/new and create a repository with the same name (including casing) as your GitHub username
  2. Create a README.md file and add your fancy code there
  3. Commit (and push)

Creating a new repository Creating a new repository

What if you already have a repository with the same name? I’d recommend renaming the existing project, or if possible, changing the content of the README file.

Inspiration

My profile README is relatively simple. You can see how it looks like by checking my GitHub profile.

Of course, you may have better ideas like placing animated portraits, skill endorsements or even the tracks that you are listening in Spotify. You can find all this and even more in a GitHub repository.

I showed you mine, now it’s your turn to show me yours.

Billboard image

The Next Generation Developer Platform

Coherence is the first Platform-as-a-Service you can control. Unlike "black-box" platforms that are opinionated about the infra you can deploy, Coherence is powered by CNC, the open-source IaC framework, which offers limitless customization.

Learn more

Top comments (0)

Billboard image

The Next Generation Developer Platform

Coherence is the first Platform-as-a-Service you can control. Unlike "black-box" platforms that are opinionated about the infra you can deploy, Coherence is powered by CNC, the open-source IaC framework, which offers limitless customization.

Learn more

👋 Kindness is contagious

Immerse yourself in a wealth of knowledge with this piece, supported by the inclusive DEV Community—every developer, no matter where they are in their journey, is invited to contribute to our collective wisdom.

A simple “thank you” goes a long way—express your gratitude below in the comments!

Gathering insights enriches our journey on DEV and fortifies our community ties. Did you find this article valuable? Taking a moment to thank the author can have a significant impact.

Okay