diff --git a/docs/wipy/general.rst b/docs/wipy/general.rst
index 8fe361d1d1436b27907212750e987ff5cc28f3d8..49e48acd470111e528d404a6f9ab0173b78a1c82 100644
--- a/docs/wipy/general.rst
+++ b/docs/wipy/general.rst
@@ -96,10 +96,15 @@ the WiPy by pressing the switch on the board, or by typing::
     >>> import machine
     >>> machine.reset()
 
-Software updates can be found in: https://github.com/wipy/wipy/releases
+Software updates can be found in: https://github.com/wipy/wipy/releases (**Binaries.zip**). 
 It's always recommended to update to the latest software, but make sure to
 read the **release notes** before.
 
+.. note::
+
+   The ``bootloader.bin`` found inside ``Binaries.zip`` is there only for reference, it's not
+   needed for the Over The Air update.
+
 In order to check your software version, do::
 
    >>> import os
@@ -108,6 +113,7 @@ In order to check your software version, do::
 If the version number is lower than the latest release found in
 `the releases <https://github.com/wipy/wipy/releases>`_, go ahead and update your WiPy!
 
+
 .. _wipy_boot_modes:
 
 Boot modes and safe boot
diff --git a/docs/wipy/tutorial/wlan.rst b/docs/wipy/tutorial/wlan.rst
index 15a9bbefe84e4a52cf321185492c2f7cd6d9f51e..40e38cbeae33ebf79f5deaa48a0a5506f34d47f4 100644
--- a/docs/wipy/tutorial/wlan.rst
+++ b/docs/wipy/tutorial/wlan.rst
@@ -50,10 +50,10 @@ IP address so that you can access it via telnet or FTP, use the following script
        wlan.ifconfig(config=('192.168.178.107', '255.255.255.0', '192.168.178.1', '8.8.8.8'))
 
    if not wlan.isconnected():
-       wlan.connect(net.ssid, auth=(net.sec, 'mywifikey'), timeout=5000)
+       # change the line below to match your network ssid, security and password
+       wlan.connect('mywifi', auth=(WLAN.WPA2, 'mywifikey'), timeout=5000)
        while not wlan.isconnected():
            machine.idle() # save power while waiting
-       break
 
 .. note::