Move original readme here

original-readme.md

@@ -0,0 +1,78 @@
+# Git-it
+
+| :computer: | What is this? |
+| --- | --- |
+| ![ss](https://raw.githubusercontent.com/jlord/git-it/master/git-it-ss.png) | A [workshopper](https://github.com/workshopper/workshopper) module for learning Git and GitHub - Social coding, y'all. <br><br> These modules run a little app in your terminal and users work their way through the challenges. See [nodeschool.io](http://nodeschool.io) for more.
+
+## Hello, future Forkers, Branchers and Pull Requesters!
+
+This app runs in your Terminal (Mac) or Bash (Windows) and has challenges for learning Git and GitHub. It uses the _real_ terminal (so you'll be learning the awesome command line), it uses _real_ Git and GitHub which means when you finish all of the challenges you'll have _real_ repositories on your GitHub account and green squares on your [contribution chart](https://github.com/blog/1360-introducing-contributions).
+
+![contributions](https://raw.githubusercontent.com/jlord/git-it/master/ghcc.png)
+
+See what topics are covered in Git-it on the [challenge table of contents](http://jlord.github.io/git-it) within the Git-it guide.
+
+Developer or workshop host? Useful links: [Contributing](https://github.com/jlord/git-it/blob/master/CONTRIBUTING.md) //  [Troubleshooting](https://github.com/jlord/git-it/blob/master/TROUBLESHOOT.md) //  [New Version in Progress!](https://github.com/jlord/git-it-electron)
+
+### Get Started
+
+Sections: [Install these first](https://github.com/jlord/git-it/blob/master/README.md#what-youll-need-to-run-git-it) // [Install Git-it](https://github.com/jlord/git-it/blob/master/README.md#install-git-it) // [Using Git-it ](https://github.com/jlord/git-it/blob/master/README.md#how-it-works) // [Tips](https://github.com/jlord/git-it/blob/master/README.md#tips-for-getting-started)
+
+---
+
+### What you'll need to run Git-it:
+
+_A few development essentials, all are free and/or free and open source._
+
+- **Git**, this is your tracker of changes!
+ - If you're on **Windows, download [GitHub Desktop](http://desktop.github.com)**, which includes Git, and use the **Git Shell** for your terminal.
+ - If you're on a **Mac**, you can install Git automatically. To do this, open the Terminal application from spotlight and type `git`. This will prompt Git to install the rest of the command line tools for Git. This should only take a few minutes. It will ask if you would like to download Xcode, which you can ignore.
+- **Node.js**, this is what this app is written in so you'll need this to run it. It's an engine for running JavaScript on servers (your computer is a server!) and will live quietly in the background. You can **download Node [here](https://nodejs.org/en/download/)** (For most, you can just pick the **Windows `.msi`** or **Mac `.pkg`** option).
+ - If you already have Node and npm, make sure you have updated versions with at least v 1.4.3 for npm.
+- **Text Editor**, if you don't have one already, you may want one for editing code*. A few options: [Atom](https://atom.io/), [Sublime Text](http://www.sublimetext.com/2), [Textmate](http://macromates.com/download), [Brackets](http://brackets.io/).
+- **English locales**, since the backend is English only at the moment. If you are using different language on your system, please refer to the corresponding section in the file [TROUBLESHOOT.md](https://github.com/jlord/git-it/blob/master/TROUBLESHOOT.md).
+
+_*There actually isn't "coding" required to complete Git-it so you're fine to use the default Notepad or TextEdit that comes with Mac/PC._
+
+### Install Git-it
+
+Once you have the essentials above, install Git-it.
+
+- Open up a terminal window and install Git-it globally on your computer (so that you can run it from anywhere). [NPM](https://www.npmjs.com/) (**which is included when you download Node.js**) delivers Node.js modules (that's what this app is) to your computer from the command line, real easy like:
+
+```bash
+$ npm install -g git-it
+```
+- _If you run into trouble with this command it may be due to permissions on your computer, **try adding 'sudo'**:_ `sudo npm install -g git-it`
+- Once it's done installing components, you can run it:
+
+```bash
+$ git-it
+```
+- This should load the menu. You're ready to go! Select the first challenge, hit enter and you're on your way!
+
+### How it Works
+
+- Once you've run `git-it` and the menu has loaded, use the arrows ↑↓ to select the first challenge and press 'enter'.
+- With the challenge loaded, follow the instructions at the bottom of the input to open the guide. _Preview a web hosted version of the guide [here](http://jlord.github.io/git-it)._
+
+![img](https://raw.githubusercontent.com/jlord/git-it/master/guide-ss.png)
+
+- Read the instructions in the guide and use your terminal to complete the tasks.
+- When you're done with a challenge, type `git-it verify` in terminal.
+- If the challenge components were not completed correctly, Git-it returns some text to help you know what went wrong.
+- Run `git-it` again to load the menu and select the next challenge!
+
+**If you have any questions about something, just create a [new issue](https://github.com/jlord/git-it/issues/new) or visit the [troubleshooting doc](https://github.com/jlord/git-it/blob/master/TROUBLESHOOT.md).**
+
+---
+
+### Tips For Getting Started
+
+**Code snippets** often times look like `$ some code-stuff --here`. The dollar sign identifies the line as one a user would enter into the command line, but you don't actually include it when you type it into terminal. In this case, you'd actually just type `some code-stuff --here`.
+
+**Variables** are indicated by `<VARIABLENAME>` in code snippets. When you actually use the line of code, replace it, including the `<>`, with your variable. For instance to make a new folder in terminal the format is, `mkdir <FOLDERNAME>`, so if you wanted to make a folder named 'octocat', you'd type: `mkdir octocat`.
+
+**Command line, terminal, bash** all basically mean the same thing: the MS-DOS, Doogie Howser looking screen full of words and numbers. It's awesomely powerful and allows you to control your computer with text commands.
+
+You can do a lot of things from your terminal like delete, rename, copy or create files and folders; run scripts and send things back and forth between servers (like the ones storing things on GitHub.com) and your computer (also a server!).