diff --git a/docs/flash.md b/docs/flash.md
index e0a6629f..62334d8d 100644
--- a/docs/flash.md
+++ b/docs/flash.md
@@ -1,10 +1,27 @@
+Adafruit provides a really nice [firmware flashing tutorial](https://learn.adafruit.com/building-and-running-micropython-on-the-esp8266/flash-firmware). Below you'll find just the basics for the two popular tools esptool and NodeMCU Flasher.
+
+!!! note "Note:"
+
+    Keep in mind that the ESP8266 needs to be put into flash mode before you can flash a new firmware!
+
+
 ## esptool
-https://github.com/themadinventor/esptool
+> A cute Python utility to communicate with the ROM bootloader in Espressif ESP8266. It is intended to be a simple, platform independent, open source replacement for XTCOM.
+
+Source: [https://github.com/themadinventor/esptool](https://github.com/themadinventor/esptool)
 
 Supported platforms: OS X, Linux, Windows, anything that runs Python
 
+**Running esptool.py**
+
+Run the following command to flash an *aggregated* binary as is produced for example by the [cloud build service](build.md#cloud-build-service) or the [Docker image](build.md#docker-image).
+
+`esptool.py --port <USB-port-with-ESP8266> write_flash 0x00000 <nodemcu-firmware>.bin`
+
 ## NodeMCU Flasher
-https://github.com/nodemcu/nodemcu-flasher
+> A firmware Flash tool for NodeMCU...We are working on next version and will use QT framework. It will be cross platform and open-source.
+
+Source: [https://github.com/nodemcu/nodemcu-flasher](https://github.com/nodemcu/nodemcu-flasher)
 
 Supported platforms: Windows
 
diff --git a/docs/support.md b/docs/support.md
index eb22931f..bede94e3 100644
--- a/docs/support.md
+++ b/docs/support.md
@@ -4,4 +4,4 @@ The [issues list on GitHub](https://github.com/nodemcu/nodemcu-firmware/issues)
 StackOverflow is the perfect place to ask coding questions. Use one or several of the following tags: [esp8266](http://stackoverflow.com/tags/esp8266), [nodemcu](http://stackoverflow.com/tags/nodemcu) or [Lua](http://stackoverflow.com/tags/lua).
 
 ## esp8266.com Forums
-esp8266.com has a few [NodeMCU specific forums](http://www.esp8266.com/viewforum.php?f=17).
\ No newline at end of file
+esp8266.com has a few [NodeMCU specific forums](http://www.esp8266.com/viewforum.php?f=17) where a number of our active community members tend to hang out.
\ No newline at end of file