Welcome to the Smartflix project! We recommend reading this README thoroughly before you get started.
You can overwrite this file whenever you like. Or, consider moving it to a
/docs
directory if you'd like to refer to it later.
This repo is set up to be integrated with Techmap. As such, there are a few rules about how to use it.
- Your aim is to complete projects (see the little "Projects" button up above? That one.)
- Projects are made up of challenges. These challenges each have a number (such as
#1 Setup a new Rails application
). You can see them all under the "Issues" button above. - To complete projects, you have to complete challenges.
- To complete a challenge, your should follow the git branch-and-merge strategy.
There are five stages to completing an issue:
- You create a new branch in the format
issueNumber-branchName
. The issue is automatically moved to the "In progress" project column. - You use the issue guidance and resources to write beautiful, tested code that solves the issue.
- You create a pull request for the issue. The issue is automatically moved to the "Review in progress" project column.
- A reviewer gives you some feedback, and you update your solution. (You don't need to make another pull request; just keep the original one open.)
- A reviewer approves your solution. The issue is automatically moved to the "Reviewer approved" project column.
- You merge your pull request into the
main
branch. The issue is automatically moved to the "Done" project column.
Note that you don't need to wait until the pull request has been merged to move forward. So long as an issue is in the "Review in progress" project column, you can branch from that issue branch and pick up the next ticket.
- You should name your branches in the following format:
issueNumber-branchName
. For instance,1-setup-a-new-rails-application
. ThebranchName
doesn't matter too much. TheissueNumber
matters a lot. It's how we track your progress. - Please avoid deleting labels from issues. We use labels for some kinds of tracking. You can add labels if you like!
- You probably want to do the challenges in the issue number order. In other words, #1 before #2, and so on.
- Please avoid moving project cards manually around in projects. It actually won't have any effect, and we'd like to save you the disappointment.
Awesome. Please let us know about it! The best thing to do is to email me and I'll jump on it as quickly as possible.