Forem: jfmartinz

Level Up Your GitHub Profile With These 20+ Amazing Resources! 🚀

jfmartinz — Thu, 12 Dec 2024 13:43:58 +0000

Wanna level up and stand out your GitHub profile? Check out these 20+ resources

README Generators

gh-profile-readme-generator A README generator that allows you to create a README file by filling in the information you want to display. It includes sections for the title, subtitle, skills, experience, and socials. Additionally, it offers add-ons like displaying a visitor count badge or automatically updating the latest dev.to blogs using GitHub Actions.

GPRM Another great tool for generating README profiles by simply filling out the required fields, similar to gh-profile-readme-generator
readme.so An online drag-and-drop editor for easily building READMEs. Use it to create your profile README or for your projects.

Banners

REHeader Generate beautiful header images for your GitHub profile READMEs.

github-profile-header-generator Simple but nice header image generator for GitHub profile READMEs with various customization options.

Icons

simple-icons A collection of 3,278 free SVG icons available for download.

skill-icons A well-curated collection of beautiful skill icons.

Badges4-README.md-Profile A collection of badges to enhance your README profile.

Stats

todoist-readme Display your Todoist stats in your README profile.

metrics An infographics generator with 30+ plugins and 300+ options to display detailed stats about your GitHub account. Supports rendering in SVG, Markdown, PDF, or JSON formats.

github-trends Level up your GitHub profile README with customizable LOC statistics.

user-statistician Generate GitHub stats SVGs for your profile README using GitHub Actions.

github-readme-stats Dynamically generate stats for your GitHub READMEs.

github-profile-summary-cards-example Template for GitHub profile summary cards, including stats like languages, repos, contributions, stars, PRs, and issues.

waka-readme-stats Add cool development metrics to your GitHub profile README.

GitHub Actions

github-activity-readme Automatically update your README file with recent GitHub activities like issues, PRs, etc using GitHub Actions.

github-action-dynamic-profile-page Automatically update your README file with your latest commits.

blog-post-workflow Automatically display your latest blog posts from platforms like Medium, dev.to, Stack Overflow, Hashnode, and more using RSS.

Other resources

readme-typing-svg A customizable SVG that simulates typing and deleting text for use in READMEs or websites.

github-readme-stackoverflow Dynamically generate your StackOverflow status for your GitHub README.

github-readme-linkedin Dynamically generate images from your LinkedIn profile for your GitHub README.

Remember, your GitHub profile is like your online resume—customize it, and make it yours!

My GitHub profile:

My Hacktoberfest 2024 Journey—reflection

jfmartinz — Sun, 03 Nov 2024 12:41:09 +0000

Hello! This is my submission for 2024 Hacktoberfest Writing challenge: Contributor Experience

Why did I joined 2024 Hacktoberfest

Why did I joined? These are the reasons why I joined this year hacktoberfest.

Passion
Open-Source has always been something I'm passionate about. In fact, this is not my first time contributing to open-source. This is my second time participating, I've also active participating in programs like GSSOC and SWOC.

Improve Technical and Soft skills
Hacktoberfest offers a great opportunity to enhance both technical and soft skills. By reading code to understand the part of the codebase, writing and fixing code, and many more, I gain hands-on experience that strengthens my technical abilities. Being able to discuss, collaborate, and solve problems with other developers is essential, and you need effective communication and collaboration skills for that.

Hacktoberfest allows me to enhance both of these skills.

Future Career
I’m currently a third year computer science student, and I know that practical experience is invaluable. By participating in Hacktoberfest, I get real-world experience working on diverse projects. This hands-on experience is essential for my future career as a developer, helping me build a strong foundation of both technical skills and soft-skills—skills that are crucial in the industry, especially soft skills.

Projects I Submitted PRs To

Here are some of the projects that I contributed to:

ephemeral-containers-plugin
I added a pull request template to the project. This template provides current and future contributors a standardized format to follow when submitting pull request to the project. This addition helps guide contributors on the details to include, which is valuable for both contributors and project maintainers.

bacloud22/Highest-priest-GPT
The website is not fully responsive across various screen size. I worked on enhancing the website’s responsiveness to improve the user experience on different devices, ensuring the site is accessible to a wider audience.

constitution-of-nepal-dataset
The maintainer made updates to JSON file paths, and I was responsible for reflecting those changes in the index.json file to ensure data references were accurate. This update helped maintain consistency in the dataset structure.

bacloud22/Highest-priest-GPT
The project’s documentation needed improvement, so I raised an issue and added several sections to the README, including:

An explanation of how the website works
Contributing guidelines
A list of all project contributors etc.

These additions make the project more accessible to everyone.

Key Learnings

Here are some learnings that I learned this journey.

Growth Comes from Stepping Out of Your Comfort Zone
I realized that as you become more comfortable with open source, it's essential to challenge yourself to go beyond fixing minor issues. Tackling more complex tasks helps you learn and improve.

In my case, I've been contributing to open source for quite a while now, and I noticed that I often stick to smaller tasks that don’t push my skills as much. While some of my contributions, like writing documentation and improving user experience, are valuable, I feel they're not enough for me to grow as a contributor and developer. I need to take on more challenging tasks to truly progress.

I’m not saying that fixing typos or handling minor issues isn’t important—these tasks are valuable, especially for beginners getting started in open source. However, as you become more comfortable, challenging yourself can lead to a more rewarding experience and help you grow significantly as a contributor.

Importance of Documentation
Another interesting I just realized in this journey is the importance of a good documentation of the project. I noticed that several projects I contributed to had issues with their documentation—some lacked essential details, others were vague or incomplete. This experience highlighted the critical role that clear and good documentation plays in helping new contributors and users understand a project. Now, I appreciate the value of good documentation more than ever; it not only improves accessibility but also empowers others to contribute effectively.

Self-Review your code
Before submitting a PR, it’s crucial to self-review your code, double-check for errors, and test it locally. Although common advice, it can’t be stressed enough how important it is to be thorough and avoid introducing problems for maintainers, ensuring a smooth collaboration and convenience both for you and maintainers of the project.

Final Thoughts

This journey with Hacktoberfest has been exciting and incredibly fulfilling. Contributing to open-source projects has always been a great feeling.

Hacktoberfest has strengthened both my technical and soft skills, which I know will be invaluable in my career. There’s still so much to learn, and I’m committed to continuing my contributions. Whether it’s to learn, connect, or simply have fun, giving back to open-source is something I’m excited to continue.

Hacktoberfest 2024: Everything You Need to Know!

jfmartinz — Fri, 13 Sep 2024 03:16:27 +0000

Hacktoberfest is Back for 2024! 🥳🎉

Every October, the open-source community is thrilled with excitement (at least for me) for one of its most anticipated events — Hacktoberfest! Whether it's the chance to earn new, custom digital badges from Holopin or grab exclusive rewards like the Hacktoberfest kit from their partners. There's something for everyone to look forward to.

In this blog, I'll cover everything you need to know about Hacktoberfest 2024: how to find issues or repositories to contribute to, how to participate, and much more.

What is Hacktoberfest?

Hacktoberfest is an annual event that takes place every October with a mission to get more people involved in open source. The event encourages everyone—coders and non-coders, regardless of skill level—to participate and make a positive impact on open-source.

It’s a month-long celebration of all things open source, where developers from around the world come together to contribute to projects, collaborate with others, and celebrate open-source with others.

Why participate on Hacktoberfest?

Why should you participate in Hacktoberfest? Is it worth your time? Here are some reasons why you might want to join Hacktoberfest 2024:

1. Digital Badges or Rewards
By participating in Hacktoberfest 2024, you can earn a customizable digital badge from Holopin that evolves with each of your pull or merge requests.

Let me show what I earned from last year's Hacktoberfest:

Holopin Badges

And here's a look at the Hacktoberfest 2023 Reward Kit:

Hacktoberfest 2023 Reward Kit

To learn more about the rewards, visit Hacktoberfest's website

2. Making your first contribution
If you’ve never contributed to open source before, this is the perfect opportunity to make your first contribution and kickstart your open-source journey.

Other reasons are:

Hone Your Technical Skills: Improve your coding skills
Network opportunities: Connect and meet with like-minded developers, maintainers, and organizations.
and many more: There are plenty of benefits, from gaining experience to simply having fun!

How to Participate?

Participating in hacktoberfest is straightforward:

Register
To participate in Hacktoberfest, simply register between September 23 and October 31. Once registered, you can start contributing from October 1. Contributions can be made on both GitHub and GitLab, but make sure that the repositories you contribute to have the 'hacktoberfest' topic.

Make Contributions
Start making your contributions between October 1 and October 31. To be eligible for the rewards (and finish Hacktoberfest), you need to submit 4 high-quality pull requests (PRs) within this period.

Ensure that you follow Hacktoberfest’s PR guidelines to make sure your contributions count. Check out this FAQ to understand how Hacktoberfest validates PRs and ensures they are counted.

For maintainers, check out this guide

Find Projects to Contribute to

In this section, I'll discuss ways to find projects and issues to work on during Hacktoberfest:

1. Use GitHub's Built-in Filter
One way to find issues for hacktoberfest is going to the issue tab (top left corner menu)

In the search field, you can use the following filters to find issues labeled for Hacktoberfest:

is:open is:issue label:hacktoberfest

You can also add other labels, such as label:good-first-issue, to find issues ideal for beginners.

2. Explore topics
You can explore Hacktoberfest-related projects by visiting this link. It showcases repositories that contain the 'hacktoberfest' topic.

3. Websites
Here are some websites you can visit to find issues or projects for Hacktoberfest:

good-first-issue
Filter by programming language, issue label, and other features that might be helpful for finding issues.
codetriage
CodeTriage provides a list of repositories with the 'hacktoberfest' label, making it easier to find repositories to contribute to.

For more ways to find projects and issues to contribute to, check out this great blog by Pradumna Saraf here

Ways to contribute

There are many ways to contribute to Hacktoberfest, and you don't need to be a coding wizard to get started. In fact, there are several ways to participate that don’t involve coding at all!

Here are some of the ways you can contribute, as mentioned on the Hacktoberfest website:

Writing: Contribute by writing or improving documentation.
Translating: Translate documents into your local language to make them more accessible.
Copy Editing: Enhance existing documentation by fixing errors, improving clarity, and refining content.
Blog Posts
Graphic Design: Create graphics, icons, and other visual elements that projects may need.

You can read more about low or non-code contributions here

That's it!

I highly encourage you to check out the official website of Hacktoberfest which contains everything you need to know about the event. Hacktoberfest is a fantastic opportunity to learn, grow, and give back to the open-source community.

So, what are you waiting for? Registration opens soon — just 10 days to go (as of writing this blog)! Don’t miss out on the chance to be part of this global celebration of open source.

See you there, and happy contributing! 🚀

Beginner’s Guide to Open-Source. Start your Open-Source Journey 🚀

jfmartinz — Sat, 10 Aug 2024 22:19:12 +0000

Are you a beginner looking to make your first contribution to open-source? Want to jumpstart your open-source journey but don't know where to start? You've come to the right place!

The world of open-source can seem vast, your first contribution can be intimidating at first, but don't worry – this blog post is here to guide you through on starting your open-source journey and making your first contribution.

We'll cover everything from understanding what open-source is, to finding issues to work on, beginner-friendly projects, and even highlight programs that can jumpstart your open-source journey.

What is Open-Source?

Open-source software is computer software that is released under a license in which the copyright holder grants users the rights to use, study, change, and distribute the software and its source code to anyone and for any purpose.

It's a collaborative community where developers of all skill levels around the world come together to contribute, collaborate, and to give back to the community.

Example of open-source projects:

Contribution Workflow

This is what a typical contribution workflow looks like. You'll encounter these steps more frequently as you contribute to open-source projects:

1. Fork

A fork on GitHub is a copy of a repository that allows users to make changes without affecting the original project.

2. Clone

Cloning a repository on GitHub copies the repository from GitHub.com to your local machine, creating a local copy that you can sync with the remote repository.

3. Edit (Your changes)

After you have cloned the remote repository and setup it in your local computer, it's time for adding your changes. You usually create your own branch for that changes.

4. Pull Request

A pull request is a proposal to merge a set of changes from one branch into another, typically from your feature branch to the main branch in a remote repository.

Why Contribute to Open-Source?

Why should you contribute to open-source? Here are some reasons why contributing to open-source is worth your time:

1. Portfolio

Your readme profile serves as your live portfolio. It allows you to showcase to other people your contributions, projects that you've worked on, demonstrating your skills and involvement in real-life projects.

2. Resume

Contributing to open-source helps you to highlights your public contributions, demonstrate your technical skills and experience with collaborative projects. You can add your contributions in your resume. Check out this article on how exactly you can do that.

3. Networking Opportunities

Contributing to open-source means collaborating with other people. You won't be working alone to solve problems. You'll meet different people from various backgrounds, expanding your network and connections.

I met most of my connections and friends through open-source.

4. Soft Skills & Technical Skills

Contributing to open source helps you enhance your soft skills, such as communication and collaboration. You'll frequently discuss and solve problems with other contributors or maintainers of the repository, improving your ability to work with other people.

It also helps you enhance your technical skills as you solve real-life problems. You'll gain practical experience working on production-level code and learn best practices from experienced developers.

Finding Issues to work on

As a beginner, finding the right issues to work on can be challenging. In this section, I'll share some websites where you can find beginner-friendly issues to get started.

But first, let's understand

What is good-first-issue label?

Good First Issue is an initiative to curate easy pickings from popular projects, so developers who've never contributed to open-source can get started quickly.

Issues marked as good first issue are good for newcomers.

Example:

You can find them in issue tab and then look for we've collected some good first issues for you link.

Find beginner-friendly issues

1. Good First Issue

Good First Issue curates easy pickings from popular open-source projects, and helps you make your first contribution to open-source.

2. Up For Grabs

Up For Grabs is a list of projects which have curated tasks specifically for new contributors. These are a great way to get started with a project, or to help share the load of working on open source projects.

3. Codetribute

Tool to help contributors find interesting good first bugs and issues to work on.

4. awesome-for-beginners

A list of awesome beginners-friendly projects.

Projects for Beginners

Here are some of beginner-friendly projects for those looking to make their first contribution to open-source:

1. first-contributions

This project aims to simplify and guide the way beginners make their first contribution. If you are looking to make your first contribution, I highly recommend start on this repo.

2. open-source-practice

Repo for you to raise a Pull Request for practice

3. fork-commit-merge

Fork, Commit, Merge. A project designed to help you familiarize yourself with the open source contribution workflow on GitHub!

Open-Source Programs

Open-Source Programs is an another excellent way to jumpstart your open-source journey. These programs encourage students and developers of all levels to contribute and begin their open-source journey. They provide a structured environment for developers of all skill levels make their first contributions under guidance and support. Here are some of the programs:

1. Hacktoberfest

Hacktoberfest: a month-long celebration of open-source projects, their maintainers, and the entire community of contributors.

2. Google Summer of Code (GSOC)

Google Summer of Code is a global, online program focused on bringing new contributors into open source software development

3. GirlScript Summer of Code (GSSOC)

GirlScript Summer of Code is a 3-month long OpenSource program by GirlScript Foundation. 10th May - 10th August 2024

4. Social Winter of Code (SWOC)

Social Winter of Code is an open-source program envisioned by the Social. It aims to bring students into the world of open source development and see the power of unified problem-solving in real time.

You can find more programs here

Final Thoughts

Your first contribution to open-source might seem challenging and intimidating at first, but it's an incredibly rewarding experience.

The earlier, the better. You will never feel completely "ready." The open-source community welcomes contributors at all levels, so don't be afraid of making mistakes. Take that first step!

So, what are you waiting for? Pick a project, fork that repository, and make your first contribution.

Goodluck! Happy Contributing! 🩷🚀