Skip to content

Latest commit

 

History

History
130 lines (84 loc) · 4.39 KB

CONTRIBUTING.md

File metadata and controls

130 lines (84 loc) · 4.39 KB
Raw

Contributing

When contributing to this repository, please first discuss the change you wish to make via issues, discord.

Please note if you are working on a certain issue then make sure to stay active with development.

Git Commit, Branch, and PR Naming Conventions

When you are working with git, please be sure to follow the conventions below on your pull requests, branches, and commits:

PR: [#ISSUE ID] Title of the PR
Branch: [ISSUE ID]-title-of-the-pr (shorter)
Commit: [[ISSUE ID]] [ACTION]: what was done

Examples:

PR: #2 Add Docker container for Postgres
Branch: 2-add-container-postgres
Commit: [2] feat: add docker container for postgres

Prerequisites

You will need to install docker on your local machine.

If you do not have docker, go here to download and install: https://www.docker.com/get-started/

If you are getting WSL error when you launch your desktop docker application, go here and follow these steps for windows: https://learn.microsoft.com/en-us/windows/wsl/install-manual#step-4---download-the-linux-kernel-update-package.

Installation

To get started with Code Racer locally, follow these steps

  1. Fork my repo and clone your fork

     git clone https://github.com/webdevcody/code-racer.git

  2. Navigate to the project directory

    cd code-racer

  3. Create a .env file inside the project's root directory.

  4. Copy and paste variables from .env.example into .env

  5. Install NPM packages

    npm i

  6. Generate a version of Prisma Client that is tailored to the models.

    npx prisma generate

  7. Open Docker Desktop Application and go back to your VSCode terminal and run this command:

    docker compose up -d

  8. Once your database is ready, push your prisma schema to the database.

    npx prisma db push

  9. Finally start your dev server.

    npm run dev

Open your browser and visit http://localhost:3000 to see the application running.

Working on New Features

If you're new to github and working with open source repositories, I made a video a while back which walks you through the process: How to make a pull request on an open source project

If you want to work on a new feature, follow these steps.

  1. Fork the repo
  2. Clone your fork
  3. Checkout a new branch
  4. Do your work
  5. Commit
  6. Push your branch to your fork
  7. Go into github UI and create a PR from your fork & branch, and merge it into upstream MAIN

Pulling in changes from upstream

You should pull in the changes that we add in daily, preferably before you checkout a new branch to do new work.

  1. git checkout main
  2. git pull upstream main

Code of Conduct

Our Pledge

In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a friendly experience for everyone, regardless of any experience to give everyone an opportunity to contribute in this project.

Our Responsibilities

The primary responsibility of contributors is to provide high-quality code contributions to the project. This involves writing, reviewing, and submitting code changes that improve the project's functionality, fix bugs, or implement new features.

Contributors should actively participate in project discussions and communicate effectively with other contributors, maintainers, and users. This includes joining discord server solely created for this project.

Contributors can play a role in the long-term maintenance of the project by actively monitoring the project's issue tracker, addressing bug reports and feature requests, and collaborating with other contributors to ensure the project remains healthy and sustainable.

Scope

This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.