Updated Getting Started sections. (#101)

Author: hristo-kanchev

First-outlook.md

@@ -8,33 +8,32 @@ Things you should try out.
 
 ### ⚠️ Common pitfalls + FAQ
 
--> [Unofficial Heaps FAQ](https://gist.github.com/Yanrishatum/ae3725a9e2b45e0766c065e573ed1f24#an-unofficial-heaps-faq)
+[Unofficial Heaps FAQ](https://gist.github.com/Yanrishatum/ae3725a9e2b45e0766c065e573ed1f24#an-unofficial-heaps-faq)
 
 ### ⭐️ Github samples
 
-Besides the [samples you can run online on the Heaps site](https://heaps.io/samples/) you should try the many [**samples from the github repository**](https://github.com/HeapsIO/heaps/#samples). There are many samples that haven't yet been added to the site of Heaps. The samples are already in your Haxe's Heaps folder on your local machine: `HaxeToolkit\haxe\lib\heaps\git\samples`. When compiling the `all.hxml` file all samples should get compiled (which currently takes about 227 MB of disk space).
+Besides the [samples you can run online on the Heaps site](https://heaps.io/samples/) you should try the many [**samples from the github repository**](https://github.com/HeapsIO/heaps/#samples).
 
-Sidenote (Windows): When using HashLink you can run them very quickly when [adding HashLink to your right mouse menues](https://github.com/HaxeFoundation/hashlink/wiki/Further-Tips#working-on-windows).
+There are many samples that haven't yet been added to the site of Heaps. The samples are already in your Haxe's Heaps folder on your local machine: `HaxeToolkit\haxe\lib\heaps\git\samples`. 
 
-### 📚 Wiki / Docs
+When compiling the `all.hxml` file all samples should get compiled (which currently takes about 227 MB of disk space).
 
-- We have many code samples and explanations on our **documentation/wiki pages** here. Have a look at all the sections. (Also compare to the [wiki pages on github](https://github.com/HeapsIO/heaps/wiki)...)
-- A [manual created by Mezo](https://facilitatedistaken.github.io/HeapsTutorial/)
+Sidenote (Windows): When using HashLink you can run them very quickly when [adding HashLink to your right mouse menues](https://github.com/HaxeFoundation/hashlink/wiki/Further-Tips#working-on-windows).
 
 ### 👩‍💻👨‍💻 Samples from other users
 
-- You can also learn from external public repositories from other **members of the community**
+You can also learn from external public repositories from other **members of the community**
   - [Smallest-Heaps-Examples](https://github.com/Beeblerox/Simplest-Heaps-Examples) by Beeblerox
   - [haxe-heaps-examples](https://github.com/joereynolds/haxe-heaps-examples) by Joe Reynolds
 
 ### 🎈 Template games for learning
 
-- Learn from **simple games** made for beginners/learning
+Learn from **simple games** made for beginners/learning
   - [[Sample games for learning]]
 
 ### 🐾 Step-by-step Tutorials
 
-- Learn from step-by-step **tutorials**
+Learn from step-by-step **tutorials**
   - [Deepnight tutorials](https://deepnight.net/tutorials/) by Deepnight/Sébastien Bénard
   - [BiteSize video playlist on YouTube](https://www.youtube.com/playlist?list=PLT0YBWiI9UjE-yTXsQF8vy0t2qF5JT0-u) by Willie The Stupid Programmer
 
@@ -46,18 +45,16 @@ Sidenote (Windows): When using HashLink you can run them very quickly when [addi
 ### 🌐 Community
 
 - Ask questions, discuss and get in touch with the **community**!
-  - https://community.heaps.io/
-  - join our **discord** channel: https://community.heaps.io/t/discord-official-channel/72
-    - we also have Haxe game jams in the "JAM TIME" channel!
+  - Discord (*#heaps* channel): https://discord.gg/sWCGm33
+  - Discourse: https://community.heaps.io/
 
 ## 📒 Discover Haxe
 
-- [Browse **Haxe libraries**](https://lib.haxe.org/) and benefit of the full potential of available Haxe libraries
-  - [understanding haxelib](https://lib.haxe.org/documentation/using-haxelib/)
-- Becoming proficient in **Haxe** will provide you with completely new ***abilities and powers*** in your code. So learning more about what Haxe has to offer as a language gives you new options to solve things. These are just some examples (for more [visit Haxe.org](https://haxe.org/)):
-  - the [Haxe manual](https://haxe.org/manual/)
-  - the [Haxe API](api.haxe.org/)
-  - the [Haxe wiki](https://github.com/HaxeFoundation/haxe/wiki) ( <- quite hidden!)
-  - the [Haxe code cookbook](https://code.haxe.org/)
-  - the [Haxe community](http://community.haxe.org/) (also visit haxe.org and see "Connect" options)
+Heaps is powered by Haxe. Learn more about Haxe here:
+  - The [Haxe website](https://haxe.org/):
+  - The [Haxe manual](https://haxe.org/manual/)
+  - The [Haxe API](https://api.haxe.org/)
+  - The [Haxe wiki](https://github.com/HaxeFoundation/haxe/wiki)
+  - The [Haxe code cookbook](https://code.haxe.org/)
+  - The [Haxe community](https://community.haxe.org/)
 

Installation.md

@@ -17,7 +17,8 @@ haxelib install heaps
 ```
 _Note that in some cases you might need to log out and log back into your computer for haxelib to be recognized as a command._
 
-You can also install directly from github to get the latest, bleeding-edge version of Heaps (at the moment this is the recommended option).
+You can also install directly from github to get the latest, bleeding-edge version of Heaps (at the moment this is the **recommended** option).
+
 ```
 haxelib git heaps https://github.com/HeapsIO/heaps.git
 ```
@@ -66,7 +67,13 @@ haxelib install hlsdl
 haxelib install hldx
 ```
 
+You can also install these libraries directly from github to get the latest versions (**recommended**):
+```
+haxelib git hlopenal https://github.com/HaxeFoundation/hashlink master libs/openal
+haxelib git hlsdl https://github.com/HaxeFoundation/hashlink master libs/sdl
+haxelib git hldx https://github.com/HaxeFoundation/hashlink master libs/directx
+```
 ## Verify the installation
-Once everything is setup, you should be able to run `hl` command from your terminal:
+Once everything is setup, you should be able to run `hl` command from your terminal (note: the version will likely be different):
 
 ![image](https://user-images.githubusercontent.com/1022912/45916745-4ef11280-be6b-11e8-8d9a-9405508ff014.png)