Update README.md

Author: EricCarrGH

README.md

@@ -1,2 +1,48 @@
-# fastbasic-starterproject
-A sample project to use in Visual Studio Code with a custom build step
+FastBasic VSCode Starter Project
+========================
+
+A sample project for *Visual Studio Code* with a custom build task to *FastBasic Cross Compile* and run the .xex in Altirra (Windows) or Atari800MacX (Mac)
+
+
+Prerequisites
+------------
+ - Install a Atari Emulator
+    -  Mac: [Atari800MacX](https://www.atarimac.com/atari800macx.php) 
+    -  Windows: [Altirra](https://www.virtualdub.org/altirra.html) 
+ - Download the latest [Fastbasic Release](https://github.com/dmsc/fastbasic/releases/)
+    
+Setup
+------------
+1. Download and install [Visual Studio Code](https://code.visualstudio.com/)
+2. Clone or download a zip of this repo
+3. Edit the build script to point to the *FastBasic Compiler* and the *Emulator*
+    - Mac:
+        1. Open **build** and change the path to your downloaded copy of the fastbasic compiler
+        2. Open terminal, go to the project folder, and type the following to make **build** executable:
+            
+            `chmod +x build`
+    
+    - Windows:
+        1. Open **build.bat** and change the path to your downloaded copy of the fastbasic compiler
+        2. Also change the path to the emulator
+ 
+Now you are ready to build the example file
+
+Build the example file
+----------
+1. Open the project folder in VS Code
+2. Open the example.bas file
+3. Build the file
+    - Mac: Press `Cmd+Shift+B`
+    - Windows: Press `Ctrl+Shift+B`
+4. VSCode will open a new terminal window, compile, then start the emulator
+
+
+Tips / Troubleshooting
+-------------------
+ - The VSCode terminal will show any Fastbasic compile errors
+ - Bind the build task to an easier to press keyboard shortcut in VSCode. I use Cmd+D (Ctrl+D windows)
+     - Press `Cmd+K, Cmd+S` ( `Ctrl+K, Ctrl+S` in Windows) to open the VSCode shortcuts window and search for `build task`
+ - Look at the terminal for other issues, like the wrong path to the compiler or emulator
+    
+