Updated a bunch

README.md

@@ -18,31 +18,34 @@ This application contains challenges for learning Git and GitHub—by using _rea
 
 ## What to Install
 
-You will need this app, Git-it as well as a text editor. You'll also of course need Git and the first challenge in Git-it helps you get that set up. But if you want to get a head start, go for it! You'll continue to use Git and your text editor throughout your bright social coding future.
+You will need this app, Git-it, git, and a text editor. The first challenge in Git-it helps you get that configured once installed. But if you want to get a head start, go for it! You'll continue to use Git and your text editor throughout your bright social coding future.
 
 As a part of the challenges you'll also create a (free) account on GitHub. If you've already got one, high-five!
 
-#### Git
+### Git
 
-We recommend installing [GitHub Desktop](http://desktop.github.com) (free) because it installs Git in the most consistent way across supported operating systems (Windows and Mac). We won't use the app itself in the challenges (but it is really useful once you get going in Git!), just the Git that it install for you.
+On Windows, download standalone installer from [https://git-scm.com/download/win](https://git-scm.com/download/win).
+Use default or recommended settings while installing git. You need to use the "Git Shell" as your terminal to complete Git-it challenges.
 
-Note—If you're using Windows, you should use the **Git Shell** app as your terminal—it is installed with GitHub Desktop. In Mac and Linux you can use the app **Terminal**, which is already on your computer.
+On Mac, download and install git following the instructions here: [https://git-scm.com/download/mac](https://git-scm.com/download/mac)
 
-#### Text Editor
+On Mac and Linux, you can use the app **Terminal**, which is already on your computer.
 
-I'm quite partial (I'm on the team!) but [Atom](http://atom.io) is a great text editor (also free) and it is built on [Electron.js](http://electron.atom.io), just like Git-it. Visit the website and download the version for your operating system. [Sublime](https://www.sublimetext.com), [Microsoft VS Code](https://code.visualstudio.com) and [Adobe Brackets](http://brackets.io) are other options.
+### Text Editor
 
-#### Git-it
+Any text editor will do it. [Sublime](https://www.sublimetext.com), [Microsoft VS Code](https://code.visualstudio.com) and [Adobe Brackets](http://brackets.io), etc.
 
-You can view the [releases](http://github.com/jlord/git-it-electron/releases) section of this repository to find the download for your operating system. Click to download your version. Once it has downloaded to your default Downloads directory, unzip the folder and run the Git-it executable. The executables for Mac, Windows and Linux:
+### Git-it
+
+You can view the [https://github.com/rambasnet/git-it-electron/releases](https://github.com/rambasnet/git-it-electron/releases) section of this repository to find the download for your operating system. Click to download your version. Once it has downloaded to your default Downloads directory, unzip or extract contents to a folder and run the Git-it executable. The executables for Mac, Windows and Linux:
 
 ![executables](https://cloud.githubusercontent.com/assets/1305617/14696588/2b10abf8-0731-11e6-945e-f3d57114bce9.png)
 
 - **Mac** Right (control) click the Git-it icon, select Open and then Open again. You can drag the icon into your Applications directory if you want, but it's not required. If needed, more [detailed installation instructions](https://github.com/jlord/git-it-electron/issues/121#issue-149747488) can be found in this issue.
 - **Windows** Double-click the executable.
 - **Linux** Double-click the executable. If the app isn't running, [see this issue](https://github.com/jlord/git-it-electron/issues/182).
 
-## Get Started!
+## Get Started
 
 Open Git-it and click the button to begin the first challenge. Have your terminal and text editor open, too. Follow along with the instructions in each challenge and use the terminal or editor as instructed.
 
@@ -54,12 +57,22 @@ When you've completed the steps in a challenge click 'Verify'. Depending on the
 
 ---
 
-### Tips For Getting Started
+## Tips For Getting Started
+
+### Code snippets
+
+Often times you'll see `$ some command --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 command --here`.
 
-**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
 
-**Variables** are indicated by `<VARIABLENAME>` in code snippets. When you actually use the line of code, replace `<VARIABLENAME>`, 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`.
+Variables are indicated by `< >` e.g., `<VARIABLENAME>` or `<variable_name>`in code snippets. When you actually use the line of code, replace `<VARIABLENAME>`, with your data/value/content. 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 and 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.
+### Command line, Terminal and Bash
+
+They 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!).
+
+### Tips for Learning Bash Commands
+
+To lean Linux/Mac Bash commands, this resource [http://linuxcommand.org/index.php](http://linuxcommand.org/index.php) is highly recommended. Note that you can run some basic utility Linux Bash commands even on Windows using git-bash or Powershell. Windows 10 and newer verion allow you to install Ubuntu as an App via WSL; see [https://docs.microsoft.com/en-us/windows/wsl/install](https://docs.microsoft.com/en-us/windows/wsl/install) for details.

WSL.txt

@@ -0,0 +1,33 @@
+- update WSL to version 2
+- open Powershell as an amdin and type
+> wsl -l -v
+> wsl --update
+> wsl --shutdown
+> wsl --set-version Ubuntu 2
+> On VMWAre VM
+  - https://marduc812.com/2020/11/30/how-to-install-wsl2-inside-vmware-fusion-virtual-machine/
+
+Windows 11
+
+- install nodejs using nvm
+$ sudo apt update -y
+$ curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
+$ nvm --version
+$ nvm install node
+$ sudo apt install -y  libgtk2.0-dev libxss1 libasound2 libgconf2-dev
+
+Install XServer for Windows
+- https://techcommunity.microsoft.com/t5/windows-dev-appconsult/running-wsl-gui-apps-on-windows-10/ba-p/1493242
+
+$ clone git-it-electron repository
+$ cd git-it-electron
+$ npm install
+- don't update
+$ npm start
+
+Windows 10
+- everything above plus
+- export LIBGL_ALWAYS_INDIRECT=1
+
+Make sure XServer is running
+- just open the saved xconfig.xlaunch file evertime the system reboots