Document preference and also provide easy-to-use backwards compatible interface.
With minor modifications to drop ESP8266 specific information not applicable to the ESP32 series. Further corrections welcome.