Skip to content
master
Switch branches/tags
Code

Latest commit

Changes:

 - Since we've changed how the production app is deployed, the deploy
   hook needs to be pointed the new hosting provider. The URL has been
changed on GitHub Secrets and the variable name has been updated in the
cron config.

 - Several users have asked details on how to run the app locally with
   dummy data. Those details have been added in the README.
aab8ad9

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time


DeepSource DeepSource CI

Welcome! 👋🏼

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.

Open-source maintainers are always looking to get more people involved, but new developers generally think it's challenging to become a contributor. We believe getting developers to fix super-easy issues removes the barrier for future contributions. This is why Good First Issue exists.

Adding a new project

You're welcome to add a new project in Good First Issue, and we encourage all projects — old and new, big and small.

Follow these simple steps:

  • Our goal is to narrow down projects for new open-source contributors. To maintain the quality of projects in Good First Issue, please make sure your GitHub repository meets the following criteria:

    • It has at least three issues with the good first issue label. This label is already present on all repositories by default. If not, you can follow the steps here.

    • It has at least 10 contributors.

    • It contains a README.md with detailed setup instructions for the project, and a CONTRIBUTING.md with guidelines for new contributors.

    • It is actively maintained.

  • Add your repository's path (in lexicographic order) in data/repositories.toml.

  • Create a new pull-request. Please add the link to the issues page of the repository in the PR description. Once the pull request is merged, the changes will be live on goodfirstissue.dev.

Setting up the project locally

Good First Issue has two components — the front-end app built with Nuxt.js and a data population script written in Python.

To contribute new features and changes to the website, you would want to run the app locally. Please follow these steps:

  1. Clone the project locally. Make sure you have Python 3 and a recent version of Node.js installed on your computer.

  2. Make a copy of the sample data files for your local app to use and rename them to the filename that the app expects. This step is important, as the front-end app won't work without these data files.

$ cp data/generated.sample.json data/generated.json
$ cp data/tags.sample.json data/tags.json
  1. Build the front-end app and start the development server.
$ yarn # install the dependencies
$ yarn dev -o # start the development server

The app should open in your browser.

Support

We usually hang out in our Discord server. Stop by to say hi! 🙌🏼