mirror of
https://github.com/pcottle/learnGitBranching.git
synced 2025-07-10 06:34:26 +02:00
readme
This commit is contained in:
parent
eade4c1d1e
commit
8bb28255a6
1 changed files with 22 additions and 0 deletions
22
README.md
22
README.md
|
@ -6,14 +6,36 @@ LearnGitBranching is a pseudo-git sandbox and interactive series of tutorials /
|
||||||
|
|
||||||
### Sandbox Mode
|
### Sandbox Mode
|
||||||
|
|
||||||
|
Sandbox mode is where you can mess around and just see what certain git commands do. It is moderately helpful, but the real magic lies in levels...
|
||||||
|
|
||||||
## Levels
|
## Levels
|
||||||
|
|
||||||
|
Type `levels` to see the available levels. These are a mix of tutorials and challenges to introduce git concepts and get newcomers familiar with certain workflows. There is also a "git golf" concept that tracks how many commands you used to solve the level :P
|
||||||
|
|
||||||
### Level Builder
|
### Level Builder
|
||||||
|
|
||||||
|
You can build levels with `build level`. The dialog should walk you through the majority of the commands -- at the end you will get a JSON blob that you can share with friends or paste into a github issue.
|
||||||
|
|
||||||
### Contributing Levels
|
### Contributing Levels
|
||||||
|
|
||||||
|
I would love for more levels to be added! I think there is a ton to learn and a ton to cover. Hopefully the community together can build a great tool for all git newcomers.
|
||||||
|
|
||||||
## Contributing
|
## Contributing
|
||||||
|
|
||||||
|
I really loose about contributing levels. For contributing functionality, you will need to install the `grunt` build tool. The general steps:
|
||||||
|
|
||||||
|
```
|
||||||
|
git clone <your fork of the repo>
|
||||||
|
cd learnGitBranching
|
||||||
|
npm install
|
||||||
|
git checkout -b newAwesomeFeature
|
||||||
|
# some changes
|
||||||
|
grunt build
|
||||||
|
git commit -am "My new sweet feature!"
|
||||||
|
git push
|
||||||
|
# go online and request a pull
|
||||||
|
```
|
||||||
|
|
||||||
## Helpful Folks
|
## Helpful Folks
|
||||||
A big shoutout to these brave souls for extensively testing our sandbox and finding bugs and/or inconsistencies:
|
A big shoutout to these brave souls for extensively testing our sandbox and finding bugs and/or inconsistencies:
|
||||||
|
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue