CONTRIBUTING
The Odin Project Web App Contributing Guide
Thank you for expressing interest in contributing to The Odin Project (TOP) web app! Before continuing through this guide, be sure you've read our general contributing guide, as it contains information that is important for all of our repos.
This contributing guide assumes you have followed the instructions in our general contributing guide to fork and clone our web app repo.
Table of Contents
- How to Contribute
- Running The Odin Project Locally
- Adding Curriculum Content
- Testing Changes Locally
How to Contribute
Due to the complexity of our web app repo compared to some of our other repos, contributing requires you to be able to run our web app locally and to run tests to ensure any changes being made look and work as expected.
Running The Odin Project Locally
Follow our instructions on running The Odin Project locally. These instructions include all installations you will need as well as optional instructions for setting up authentication.
Adding Curriculum Content
When new content is ready to be or has already been merged in the TOP curriculum repo, the web app must be updated to render that new content. The following instructions cover how to add new curriculum content to the web app, but you can also refer to them when editing existing content:
- Adding a lesson
- Adding a section
- Adding a course
- Adding a path
Testing Changes Locally
Before submitting a pull request (PR) to our web app repo, you should run the following commands locally to test that any changes made don't cause any failures. This can be quicker than waiting for your PR to finish running its checks to see whether there are any failures, and it can also help prevent you from making an unnecessary amount of commits that all fail to resolve a test failure.
bin/ci---
README
The Odin Project
The Odin Project (TOP) is an open-source curriculum for learning full-stack web development. Our mission is to provide a comprehensive curriculum to learn web development for free. We help users learn the skills and build the impressive portfolio of projects they need to get hired as a web developer.
Some of the topics we cover include:
- Ruby
- Ruby on Rails
- SQL
- HTML and CSS
- Javascript
- Node
- React
- How to go about getting a job in the industry
This repo contains the TOP app which pulls in lesson content as well as front-end and back-end code. To see the actual lesson content that gets pulled in, please go to the TOP curriculum repo.
Our community can be found on the TOP Discord server.
Contributing
The Odin Project depends on open-source contributions to improve, grow, and thrive. We welcome contributors of all experience levels and backgrounds to help maintain this awesome curriculum and community. If you would like to contribute to our curriculum, be sure to thoroughly read our contributing guide.
---