DEV Community

Cover image for πŸ“Steps to take before starting a new Open-source project.πŸ“
Kaiwalya Koparkar
Kaiwalya Koparkar

Posted on β€’ Edited on

8 2

πŸ“Steps to take before starting a new Open-source project.πŸ“

In this blog, we will see some good practices which you can include in your next open source project.

πŸ”– License Agreement:

It is said that if your project does not consist of a License agreement then it is not an open-source project but it is a free source project. So it is always good practice to add one to your project. You can add either of the pre-made licenses or add a custom license.

πŸ”– Readme.md:

It is obvious that you know your project very well and knows how to run it on the local system. But, this is not the case with other people who want to contribute/use your project. It is best practice to add a readme file in your project which includes the following:

  • About project
  • Project tags (https://shield.io/)
  • Screenshot / GIF of working project
  • Pre-requisites
  • Instructions for new contributors
  • How to set up a local environment
  • Any additional instruction
  • Recognition to contributors/ sponsors

πŸ”– Contributing.md:

This is an important file and acts as a manual for new contributors to your project. It may contain the following things

  • Pre-requisites
  • Instructions for new contributors
  • How to set up a local environment

πŸ”– CODE_OF_CONDUCT.md:

This is a most undervalued file. The name of the file is self-explanatory. This file contains the rules and regulations one needs to follow while contributing to the project and interacting with other contributors to the project.

πŸ”– Issue & PR Template:

There is yet another important file you should include in your project. This files basically ensures that the raise issue/PR gives the information to the point and creates equilibrium between other issues/PR

πŸ”– GitHub Actions:

This is optional. But, if you add an action to your project. You can take your project to another level. These actions are basically triggers that initiate after a particular task. For example, you can add an action that congratulates the contributor after raising an issue/PR.

Do your career a big favor. Join DEV. (The website you're on right now)

It takes one minute, it's free, and is worth it for your career.

Get started

Community matters

Top comments (1)

Collapse
 
vinzvinci profile image
Vincent Villafuerte β€’

Great content!

A Workflow Copilot. Tailored to You.

Pieces.app image

Our desktop app, with its intelligent copilot, streamlines coding by generating snippets, extracting code from screenshots, and accelerating problem-solving.

Read the docs

πŸ‘‹ Kindness is contagious

Dive into an ocean of knowledge with this thought-provoking post, revered deeply within the supportive DEV Community. Developers of all levels are welcome to join and enhance our collective intelligence.

Saying a simple "thank you" can brighten someone's day. Share your gratitude in the comments below!

On DEV, sharing ideas eases our path and fortifies our community connections. Found this helpful? Sending a quick thanks to the author can be profoundly valued.

Okay