mirror of
https://github.com/freeCodeCamp/freeCodeCamp.git
synced 2026-05-28 18:26:54 +00:00
Update README.md to add details (#821)
* Add details to readme * Fix typos * Adds image and more fixes * Changed commands a bit * Adds more detailed explanations * Change wording
committed by
Jonathan
parent
e781b6a645
commit
bd18dd61a5
+48
-12
@@ -8,19 +8,55 @@ Our open source community's Wiki focuses on answering your questions about learn
|
|||||||
|
|
||||||
## Get a Fork ready
|
## Get a Fork ready
|
||||||
|
|
||||||
You can get your own fork by using the button or clicking [this](https://github.com/FreeCodeCamp/wiki/new/master?readme=1#fork-destination-box).
|
1. Fork it: You can get your own fork of our wiki by using the button or clicking [this](https://github.com/FreeCodeCamp/wiki/new/master?readme=1#fork-destination-box).
|
||||||
Once you get a fork, you will clone it with `git clone url` where `url` is the link to your fork.
|
|
||||||
|
|
||||||
Once that is done, you can start contributing by checking our [issues](https://github.com/FreeCodeCamp/wiki/issues) and creating nee pull requests.
|

|
||||||
|
|
||||||
|
2. Once you have forked the repository, you will clone it with:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
$git clone https://github.com/YOUR-USERNAME/wiki.git
|
||||||
|
```
|
||||||
|
|
||||||
|
This will make a local copy on your machine.
|
||||||
|
|
||||||
|
3. Add the remote: You will need a way to keep your fork synchronized with the original repository. The following command will show you **verbose** list of the current remotes you have.
|
||||||
|
|
||||||
|
```sh
|
||||||
|
$git remote -v
|
||||||
|
origin https://github.com/YOUR_USERNAME/wiki.git (fetch)
|
||||||
|
origin https://github.com/YOUR_USERNAME/wiki.git (push)
|
||||||
|
```
|
||||||
|
|
||||||
|
This means there is no remote pointing to the original repository you forked from. You would add it with:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
$git remote add upstream https://github.com/FreeCodeCamp/wiki.git
|
||||||
|
```
|
||||||
|
|
||||||
|
This will create a new remote named **upstream**. You can verify the changes with `git remote -v`
|
||||||
|
|
||||||
|
```sh
|
||||||
|
$git remote -v
|
||||||
|
origin https://github.com/YOUR_USERNAME/wiki.git (fetch)
|
||||||
|
origin https://github.com/YOUR_USERNAME/wiki.git (push)
|
||||||
|
upstream https://github.com/FreeCodeCamp/wiki.git (fetch)
|
||||||
|
upstream https://github.com/FreeCodeCamp/wiki.git (push)
|
||||||
|
```
|
||||||
|
|
||||||
|
4. Sync the fork when needed: After another PR has been merged, you will need to fetch the changes and rebase your work.
|
||||||
|
|
||||||
|
```sh
|
||||||
|
$git fetch --all --prune # fetch all remote repos and delete any deleted branches
|
||||||
|
$git checkout master # switch to `master` branch
|
||||||
|
$git rebase --preserve-merges upstream/master # preserve merge commits while rebasing
|
||||||
|
### or better
|
||||||
|
$git reset --hard upstream/master # SAFE! to do as `master` branch shouldn't be committed to directly
|
||||||
|
$git push origin master # push changes to your forked wiki repo
|
||||||
|
```
|
||||||
|
|
||||||
|
5. Once you have completed these steps, you can start contributing by checking our [issues](https://github.com/FreeCodeCamp/wiki/issues) and creating new pull requests.
|
||||||
|
|
||||||
## Contribution Guides
|
## Contribution Guides
|
||||||
|
|
||||||
We currently have a couple of guides to help you contribute, via the browser, command line or desktop application.
|
We currently have a couple of guides to help you contribute, via the browser, command line or desktop application. You can find this and many more guides and information on the [Wiki Central Page](https://github.com/FreeCodeCamp/FreeCodeCamp/wiki/Wiki).
|
||||||
|
|
||||||
- [How To Contribute From Your Browser:](Wiki-Contribute-Online) This is currently the easiest way we have to contribute. A simplified version can be found on [here](https://medium.freecodecamp.com/how-to-land-your-first-open-source-contribution-from-your-browser-in-15-minutes-756d9bbf81ad) also.
|
|
||||||
- [How To Contribute To The Wiki Locally:](Wiki-Contribute-Local-GUI) This is a guide that will show you how to have a local copy so you can make changes from your computer, it also works for contributing to the main repository.
|
|
||||||
- [Pull Request Guidelines](PULL_REQUEST_TEMPLATE)
|
|
||||||
- [More on how to make a pull request from a fork](Pull-Request-Contribute)
|
|
||||||
- [How to Squash Commits:](git-rebase#squashing-multiple-commits-into-one) We required only one commit per Pull Request unless otherwise specified by a moderator.
|
|
||||||
|
|
||||||
you can find this and much more guides and information on the [Wiki Central Page](https://github.com/FreeCodeCamp/FreeCodeCamp/wiki/Wiki).
|
|
||||||
|
|||||||
Reference in New Issue
Block a user