Skip to content

Latest commit

 

History

History
82 lines (61 loc) · 3.93 KB

CONTRIBUTING.md

File metadata and controls

82 lines (61 loc) · 3.93 KB
Raw

Contributing Documentation

Thank you for your interest in contributing to the Developer Quiz site. developerquiz.org is the companion website to the Learn to Code RPG Game, a visual novel game developed by freeCodeCamp to help you learn how to code.

How to setup the project locally

Here are directions on how to fork the freeCodeCamp/Developer_Quiz_Site repository:
https://docs.github.com/en/get-started/quickstart/fork-a-repo

In the command line:

  1. Clone the repo by typing git clone https://github.com/YOUR-GITHUB-USERNAME/Developer_Quiz_Site.git
  2. Then type cd Developer_Quiz_Site to go into the project's directory.
  3. Ensure Node.js and NPM are installed on machine
  4. Install dependecies with npm install
  5. Test local changes:
    • Option A: NPM
      1. Run the project with npm start
    • Option B: Docker
      1. Ensure docker is installed on machine. Installations instructions can be found on the official Docker docs.
      2. Build the docker image with docker build -t developer-quiz-site .
      3. Run the docker container: docker container run --rm -it -p 3000:3000 developer-quiz-site or alternatively, npm run start:local-docker.
      4. Visit localhost:3000 in a browser to view the site!
  6. Have fun 🚀

Guidelines for adding quiz questions

We are looking to add more quiz questions for the following categories:

  • JavaScript
  • Python
  • Linux
  • SQL
  • Computer Science
  • Quality Assurance
  • Agile
  • Security

The quiz question categories can be found in the data folder. https://github.com/freeCodeCamp/Developer_Quiz_Site/tree/main/src/data

Before you add any quiz questions, please check to make sure that it does not already exist in the file.

All questions follow this format:

  {
    Question: "Which one of these data structures follows the FIFO (First In First Out) method?",
    Answer: "Queue",
    Distractor1: "Stack",
    Distractor2: "Array",
    Distractor3: "Linked List",
    Explanation: "A queue follows the First In First Out (FIFO) method as the element which gets inserted first gets removed first.",
    Link: "https://youtu.be/B31LgI4Y4DQ?t=16410",
  },

For the Explanation field, please keep your explanations to a couple of sentences. For the link field, please make sure to use a freeCodeCamp article, freeCodeCamp YouTube video or official documentation. If you choose to reference a video, please make sure to include the timestamp for the topic covered.

You can read more about how to create timestamps in this helpful article.

How to contribute and make a pull request

  1. In the command line, make sure you are in the Developer Quiz directory. cd Developer_Quiz_Site
  2. Create and switch to a new branch by using the following command: git checkout -b new-branch-name
  3. Add your changes to the project.
  4. In the command line, stage your changes by using the git add . command.
  5. Commit your changes by using the git commit -m "commit message" command.
  6. Push up your changes to the remote branch on GitHub by using the git push -u origin branch_name command.
  7. Open up a pull request (PR) directed to our main branch.
  8. Then the maintainers will review your PR and either request changes or approve it.

If you need any help, please reach out on the freeCodeCamp forum.

How to propose new features

If you are interested in proposing new features, please open up a new GitHub discussion with details for the proposed feature.

How to report bugs in the codebase and typos in the documentation

If you spot a bug in the codebase or issues with the documentation, please open up a GitHub issue detailing the problem.