diff --git a/Hardware-API.md b/Hardware-API.md
index b2b14a8..406b117 100644
--- a/Hardware-API.md
+++ b/Hardware-API.md
@@ -348,7 +348,7 @@ Methods:
 - `wlan.scan()` perform a network scan and return a named tuple of the form:
   `(ssid, bssid, auth, channel, rssi)`
 - `wlan.mac([mac])` get or set the MAC address. The MAC address is a `bytes` object of length 6.
-- `wlan.connect(ssid, *, bssid, auth=None, timeout=None)` Connect to the network specified by the SSID (and optionally the BSSID) using the given authentication.
+- `wlan.connect(ssid, auth=None, *, bssid, timeout=None)` Connect to the network specified by the SSID using the given authentication. Optionally specify the BSSID and a timeout.
 - `wlan.disconnect()` Closes the current connection. NOHEAP
 - `wlan.isconnected()` returns `True` if connected and IP address has been assigned. NOHEAP
 - `wlan.ifconfig(id=0, config=[(ip, netmask, gateway, dns) or 'dhcp'])` get or set the IP configuration. The `id` is the interface id, and defaults to zero. In the case of `AP+STA` mode, the NIC effectively has 2 interfaces that can be configured independently using `id=0` for the AP and `id=1` for the STA. Alternatively, a port can choose to use string names for the `id`, e.g. `id='STA'` and `id='AP'`.