freeCodeCamp - show the local weather project
A simple front-end app displaying the local weather using freeCodeCamp API.
It is a standalone front-end single page application built with HTML5, TailwindCSS and JavaScript. It is developed by the members of the freeCodeCamp community in order to develop soft skills, get more familiar with Fetch API, working with JSON, Git workflow and develop general coding skills. And also, just for the sake of happy coding!
- Open your teminal and go to your projects directory
- Clone this repository to your local machine
git clone https://github.com/Dorfieeee/fcc-local-weather.git - Change to the project directory
cd fcc-local-weather - Install the dependencies using npm program.
npm install - Run the project
npm start
Anyone can contribute.
Picking up an issue should be your first step to contributing!
Once you have decided on an issue, assign yourself by clicking "assign to me"
- All pull requests must be reviewed and approved before they can be merged
- All commits must be made from a unique branch name! (ex. do not name your branch with your name/do not reuse a branch unless you are committing another change to the same branch, use names such as fixed-documentation-typo, etc)
Make sure to read the change guidelines!
Once you finish making your changes, you are ready to push your change!
Making a contribution using Github Desktop
Once you make your Pull Request, you are done!
This assumes you have already cloned the repo and are on the default main branch, to change back to the main branch
git checkout main
- Pull all the latest changes
git pull - Checkout a new branch
git checkout -b descriptive-branch-name - Make your changes
- Add all of your changes files to the commit
git add .from the root of the project dir - Check that all of the files you want committed are in git status
- Make your commit
git commit- Make sure your commit message is descriptive
- The first line is the title of the commit
- Following lines are the description of the commit
- Push your commit
git push -u origin your-branch-name - The previous command will give you a link which will direct you to a page where you can submit your pull request
The guidelines must be followed and may result in your change being denied
- Your title or description of your commit MUST include the words: closes, fixes, resolves followed by the issue # (ex. fixes #5, or resolves #7)
- The title of your commit must be descriptive of the change
- The description should define what changes were made even if they are repeated from the issue
- A pull request should contain all the required changes to complete an issue
- Every Pull Request will be blocked until it is reviewed by someone else
- If you are the reviewer and are approving a change, you are responsible for merging the change and deleting the branch
You should only be creating bug, question, and help wanted issues.
- Under issue click "new issue"
- Add a descriptive title (ex. Doesn't Properly Load When Clicking X)
- Add a descriptive description (ex. no "It don't work")
- This should include a DoD (Definition of Done) if it a feature request
- This should include the steps to reproduce if it is a bug
- Add any relevant labels
- Milestone and Assignee should be left alone (unless you are assigning yourself)
These will be handled on a case by case basis by the project manager. If you have a merge conflict, please reach out to the project manager
If you get this, it means that your change need a little more work before it is accepted! This is fine! The person who requested the changes will specify what changes need to be made, if you have any follow up questions, reach out to the project manger! Make sure that you make the changes to the same branch and commit them. Github will automatically track that changes have been made and that it needs re-review. You should also mark the requested changes as resolved once you are done making them!
If you believe something is missing here, feel free to add it or talk to the project manager!