Tips to use GitHub as your Portfolio
?? Pachi Parra
Developer Advocate @GitHub | Developer Relations | Tech Community Manager | Founder @Abacate DevRel & Feministech
Hello everyone!
Today I came to talk to you about a topic I love to talk about because it applies to people of all skill levels and any area within technology: How to use GitHub as a Portfolio!
Although it's not mandatory, it's common for recruiters to want to see your GitHub and sometimes also ask for a Portfolio, so why not combine the two?
GitHub is the ideal place because there you can showcase examples of your code, your progress, your studies, and initiatives you've been involved in. In today's article, I'll share some tips on how to do that.
1. Your README
Let's start with the most important part, your homepage on GitHub: The README.
You can use text, graphics, and GIFs to convey your message here. Check out mine:
How to do it?
Firstly, you have to create this file.
Now you have access to this ??special?? repository.
What do I put here?
You can put several things. In mine, I have my Bio, my Skills, Social media, and a list of my 5 most recent articles.
My recommendation is to have at least the bio. Mine is in English, but write in the language most relevant to you!
If you're feeling uninspired, I recommend using this site https://www.profileme.dev/. Here's a template to fill out, and in the end, you'll have access to the .md file, so just copy and paste it into your README.
If you're familiar with markdown and are a creative person, you can make this look nice, like GitHub Star Leticia L. 's Profile , which is simple but lovely:
领英推荐
2. Fill in the Left Column
When you visit a profile on GitHub, even if the person hasn't created the README we talked about above, they have a column on the left with basic information, and it's important that you have this section filled.
I'll use another GitHub Star, Julio Arruda , as an example:
His profile is complete, and you can follow this example by filling in:
Cool, now you have a fully completed profile column and a neat README! That's the basics, but we can do a little more.
3. "Pinned" Projects
Right below your README, you can "pin" projects, which means highlighting them.
You can choose from 1 to 6 of your projects. Pick the projects you're most proud of! Here, you can see the choices of GitHub Star Erika Heidi :
A tip I give for all repositories, but especially important for those you want to highlight, is to write a short description of the project. Just what the project does and the technology used.
In the example image above, for the MiniCli project, the description is A minimalist framework for command-line applications in PHP.
This is important because this information is visible without the person having to click on the repository to know more. So, when they open the repo, it interests them. This makes it easier for recruiters to look at your profile.
How's your profile?
Well, folks, those are my main tips to make your profile not only attractive but also functional. These tips might seem simple, but in the current competitive market, small things can make a difference in the selection process. Let me know what you have done on your profile!