mirror of
https://github.com/pcottle/learnGitBranching.git
synced 2025-07-31 16:14:53 +02:00
parent
c5a4106a43
commit
8d503d6049
1 changed files with 10 additions and 6 deletions
16
README.md
16
README.md
|
@ -3,6 +3,8 @@
|
||||||
LearnGitBranching is a git repository visualizer, sandbox, and series of educational tutorials and challenges. Its primary purpose is to help developers understand git through the power of visualization (something that's absent when working on the command line).
|
LearnGitBranching is a git repository visualizer, sandbox, and series of educational tutorials and challenges. Its primary purpose is to help developers understand git through the power of visualization (something that's absent when working on the command line).
|
||||||
|
|
||||||
You can input a variety of commands into LearnGitBranching (LGB) -- as commands are processed, the nearby commit tree will dynamically update to reflect the effects of each command:
|
You can input a variety of commands into LearnGitBranching (LGB) -- as commands are processed, the nearby commit tree will dynamically update to reflect the effects of each command:
|
||||||
|
|
||||||
|
|
||||||
<img src="https://raw.github.com/pcottle/learnGitBranching/master/assets/learnGitBranching.png"/>
|
<img src="https://raw.github.com/pcottle/learnGitBranching/master/assets/learnGitBranching.png"/>
|
||||||
|
|
||||||
This visualization combined with tutorials and "levels" can help both beginners and intermediate developers polish their version control skills. A quick demo is available here:
|
This visualization combined with tutorials and "levels" can help both beginners and intermediate developers polish their version control skills. A quick demo is available here:
|
||||||
|
@ -37,6 +39,8 @@ LearnGitBranching is a pretty simple application (from a technical perspective).
|
||||||
|
|
||||||
Because the app contains a lot of code, I have written everything into Nodejs-style modules. The modules are packaged together with the `Browserify` and then sent down in a format the browser can understand.
|
Because the app contains a lot of code, I have written everything into Nodejs-style modules. The modules are packaged together with the `Browserify` and then sent down in a format the browser can understand.
|
||||||
|
|
||||||
|
As of December 2013, I've migrated the build process to use Grunt >0.4, since the older version was giving a lot of people build headaches. It should be fairly rock solid now!
|
||||||
|
|
||||||
Here is the high level process of the build:
|
Here is the high level process of the build:
|
||||||
|
|
||||||
* Code is written into the node.js modules which require other modules
|
* Code is written into the node.js modules which require other modules
|
||||||
|
@ -55,8 +59,8 @@ Thus, if you build the app locally, all you have to do in order to run the app i
|
||||||
## Building yourself / Contributing Functionality
|
## Building yourself / Contributing Functionality
|
||||||
|
|
||||||
For contributing core functionality in the app, you'll probably want to test your changes
|
For contributing core functionality in the app, you'll probably want to test your changes
|
||||||
at least once before submitting a pull request. That means you'll need the `grunt` build tool. It's a fairly
|
at least once before submitting a pull request. That means you'll need the `grunt` build tool:
|
||||||
common tool, however I use a slightly older version.
|
http://gruntjs.com/getting-started
|
||||||
|
|
||||||
You'll also need `npm` to download all the dependencies of the project.
|
You'll also need `npm` to download all the dependencies of the project.
|
||||||
|
|
||||||
|
@ -68,11 +72,10 @@ cd learnGitBranching
|
||||||
npm install # to install all the node modules I depend on
|
npm install # to install all the node modules I depend on
|
||||||
git checkout -b newAwesomeFeature
|
git checkout -b newAwesomeFeature
|
||||||
# some changes
|
# some changes
|
||||||
./node_modules/grunt/bin/grunt fastBuild # to use the npm version of grunt
|
grunt fastBuild
|
||||||
# after building you can open up your browser to the index.html that is generated and see your changes
|
# after building you can open up your browser to the index.html that is generated and see your changes
|
||||||
grunt watch # will keep watch over files and fastBuild whenever they change. lot of CPU though
|
|
||||||
# more changes
|
# more changes
|
||||||
./node_modules/grunt/bin/grunt build # build runs the tests and lint as well
|
grunt build
|
||||||
git commit -am "My new sweet feature!"
|
git commit -am "My new sweet feature!"
|
||||||
git push
|
git push
|
||||||
# go online and request a pull
|
# go online and request a pull
|
||||||
|
@ -92,6 +95,7 @@ And the following heroes for assisting in translating:
|
||||||
* "scientific-coder"
|
* "scientific-coder"
|
||||||
* "ace-coder"
|
* "ace-coder"
|
||||||
* Joël Thieffry
|
* Joël Thieffry
|
||||||
|
* Jens Bremmekamp ("nem75")
|
||||||
|
|
||||||
Also huge shoutout for everyone who has put up a pull request that was pulled:
|
Also huge shoutout for everyone who has put up a pull request that was pulled:
|
||||||
|
|
||||||
|
@ -114,7 +118,7 @@ Also huge shoutout for everyone who has put up a pull request that was pulled:
|
||||||
* Allen Guo
|
* Allen Guo
|
||||||
* Timothy Qiu
|
* Timothy Qiu
|
||||||
* Hyunjin CHA
|
* Hyunjin CHA
|
||||||
* "nem75"
|
* Jens Bremmekamp ("nem75")
|
||||||
* Fabio Crisci (piuccio)
|
* Fabio Crisci (piuccio)
|
||||||
* Max Sikström (pengi) [tag support!!]
|
* Max Sikström (pengi) [tag support!!]
|
||||||
* "rogererens"
|
* "rogererens"
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue