From: Angus Gratton <angus@espressif.com>
Date: Wed, 27 Sep 2017 01:13:20 +0000 (+1000)
Subject: docs: Add introduction section for WiFi, replace boilerplate
X-Git-Tag: v3.1-dev~59^2~1
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=9a96c8379e542ed17ece7436924f34ba3ce85c5e;p=esp-idf

docs: Add introduction section for WiFi, replace boilerplate
---

diff --git a/docs/api-reference/wifi/esp_wifi.rst b/docs/api-reference/wifi/esp_wifi.rst
index 29ecb3e3b6..c8091e0078 100644
--- a/docs/api-reference/wifi/esp_wifi.rst
+++ b/docs/api-reference/wifi/esp_wifi.rst
@@ -1,12 +1,18 @@
 Wi-Fi
 =====
 
-Overview
---------
+Introduction
+------------
 
-`Instructions`_
+The WiFi libraries provide support for configuring and monitoring the ESP32 WiFi networking functionality. This includes configuration for:
 
-.. _Instructions: ../template.html
+- Station mode (aka STA mode or WiFi client mode). ESP32 connects to an access point.
+- AP mode (aka Soft-AP mode or Access Point mode). Stations connect to the ESP32.
+- Combined AP-STA mode (ESP32 is concurrently an access point and a station connected to another access point).
+
+- Various security modes for the above (WPA, WPA2, WEP, etc.)
+- Scanning for access points (active & passive scanning).
+- Promiscuous mode monitoring of IEEE802.11 WiFi packets.
 
 Application Examples
 --------------------