API template

- reflected template in other DRAFT API dcouments
- DRAFT of Bluetooth API
- link fixes in CONTRIBUTING.rst

CONTRIBUTING.rst

@@ -19,7 +19,7 @@ Before sending us a Pull Request, please consider this list of points:
 
 * Is the code adequately commented for people to understand how it is structured?
 
-* Is there documentation or examples that go with code contributions? [There are additional suggestions for writing good examples in the examples README](examples/README.md).
+* Is there documentation or examples that go with code contributions? `There are additional suggestions for writing good examples in the examples README <https://github.com/espressif/esp-idf/tree/master/examples>`_.
 
 * Are comments and documentation written in clear English, with no spelling or grammar errors?
 
@@ -39,4 +39,6 @@ If this process passes, it will be merged onto the public github repository.
 Legal Part
 ----------
 
-Before a contribution can be accepted, you will need to sign our :doc:`Contributor Agreement <docs/contributor-agreement>`. You will be prompted for this automatically as part of the Pull Request process.
+Before a contribution can be accepted, you will need to sign our `Contributor Agreement <http://esp-idf.readthedocs.io/en/latest/contributing.html>`_. You will be prompted for this automatically as part of the Pull Request process.
+
+

docs/Doxyfile

@@ -1,13 +1,13 @@
-PROJECT_NAME		= "ESP32 Programming Guide"
+PROJECT_NAME = "ESP32 Programming Guide"
-XML_OUTPUT			= xml
+XML_OUTPUT = xml
-GENERATE_LATEX		= NO
+GENERATE_LATEX = NO
-GENERATE_MAN		= NO
+GENERATE_MAN = NO
-GENERATE_RTF		= NO
+GENERATE_RTF = NO
-CASE_SENSE_NAMES	= NO
+CASE_SENSE_NAMES = NO
-INPUT				= ../components/esp32/include/esp_wifi.h ../components/driver/include/driver/gpio.h ../components/esp32/include/rom/gpio.h
+INPUT = ../components/esp32/include/esp_wifi.h ../components/driver/include/driver/gpio.h ../components/esp32/include/rom/gpio.h ../components/bt/include/bt.h
-RECURSIVE			= YES
+RECURSIVE = YES
-QUIET				= YES
+QUIET = YES
-JAVADOC_AUTOBRIEF	= YES
+JAVADOC_AUTOBRIEF = YES
-GENERATE_HTML		= NO
+GENERATE_HTML = NO
-GENERATE_XML		= YES
+GENERATE_XML = YES
-WARN_LOGFILE		= "DoxyGenWarningLog.txt"
+WARN_LOGFILE = "DoxyGenWarningLog.txt"

docs/api/bt.rst

@@ -0,0 +1,31 @@
+Bluetooth API
+=============
+
+Overview
+--------
+
+`Instructions <http://esp-idf.readthedocs.io/en/latest/api/template.html>`_
+
+Application Example
+-------------------
+
+`Instructions <http://esp-idf.readthedocs.io/en/latest/api/template.html>`_
+
+Reference
+---------
+
+`Instructions <http://esp-idf.readthedocs.io/en/latest/api/template.html>`_
+
+Type Definitions
+^^^^^^^^^^^^^^^^
+
+.. doxygentypedef:: vhci_host_callback
+
+Functions
+^^^^^^^^^
+
+.. doxygenfunction:: API_vhci_host_check_send_available
+.. doxygenfunction:: API_vhci_host_register_callback
+.. doxygenfunction:: API_vhci_host_send_packet
+.. doxygenfunction:: bt_controller_init
+

docs/api/esp_wifi.rst

@@ -1,6 +1,21 @@
 Wi-Fi API
 =========
 
+Overview
+--------
+
+`Instructions <http://esp-idf.readthedocs.io/en/latest/api/template.html>`_
+
+Application Example
+-------------------
+
+`Instructions <http://esp-idf.readthedocs.io/en/latest/api/template.html>`_
+
+Reference
+---------
+
+`Instructions <http://esp-idf.readthedocs.io/en/latest/api/template.html>`_
+
 Macros
 ------
 

docs/api/example.rst

@@ -1,41 +0,0 @@
-Example Visualizations
-======================
-
-Function prototpe
------------------
-
-.. c:function:: esp_err_t esp_wifi_get_ap_list (uint16_t *number, wifi_ap_list_t *ap_list)
-.. c:function:: esp_err_t esp_wifi_set_protocol (wifi_interface_t ifx, uint8_t protocol_bitmap)
-
-
-Function definition
--------------------
-
-Wi-Fi
-^^^^^
-.. doxygenfunction:: esp_wifi_init
-.. doxygenfunction:: esp_wifi_set_config
-
-GPIO
-^^^^
-.. doxygenfunction:: gpio_isr_register
-
-Led Control
-^^^^^^^^^^^
-
-.. doxygenfunction:: ledc_timer_set 	
-
-
-Enum definition
----------------
-
-.. doxygenenum:: wifi_auth_mode_t
-
-
-Struct definition
------------------
-
-.. doxygenstruct:: wifi_scan_config_t
-   :members:
-
-

docs/api/gpio.rst

@@ -1,9 +1,24 @@
 GPIO API
 ========
 
-Functions
+Overview
+--------
+
+`Instructions <http://esp-idf.readthedocs.io/en/latest/api/template.html>`_
+
+Application Example
+-------------------
+
+`Instructions <http://esp-idf.readthedocs.io/en/latest/api/template.html>`_
+
+Reference
 ---------
 
+`Instructions <http://esp-idf.readthedocs.io/en/latest/api/template.html>`_
+
+Functions
+^^^^^^^^^
+
 .. doxygenfunction:: gpio_config
 .. doxygenfunction:: gpio_set_intr_type
 .. doxygenfunction:: gpio_intr_enable
@@ -16,9 +31,7 @@ Functions
 .. doxygenfunction:: gpio_wakeup_disable
 .. doxygenfunction:: gpio_isr_register
 
-*Example code:*
+*Example code:* Configuration of GPIO as an output
-
-Configuration of GPIO as an output
 
 .. code-block:: c
 
@@ -30,7 +43,7 @@ Configuration of GPIO as an output
     io_conf.pull_up_en = 0;                            //disable pull-up mode
     gpio_config(&io_conf);                             //configure GPIO with the given settings
 
-Configuration of GPIO as an input
+*Example code:* Configuration of GPIO as an input
 
 .. code-block:: c
 
@@ -43,7 +56,8 @@ Configuration of GPIO as an input
     gpio_config(&io_conf);                             //configure GPIO with the given settings
 
 
-Low level ROM GPIO functions
+ROM GPIO functions
+^^^^^^^^^^^^^^^^^^
 
 .. doxygenfunction:: gpio_init
 .. doxygenfunction:: gpio_output_set
@@ -65,3 +79,5 @@ Low level ROM GPIO functions
 .. doxygenfunction:: gpio_pad_pulldown
 .. doxygenfunction:: gpio_pad_unhold
 .. doxygenfunction:: gpio_pad_hold
+
+

docs/api/template.rst

@@ -0,0 +1,61 @@
+Template API
+=============
+
+Overview
+--------
+
+INSTRUCTIONS: Provide overview where and how this API may be used. For large number of functions, break down description into groups.
+
+
+Application Example
+-------------------
+
+INSTRUCTIONS: Provide one or more pratical examples to demonstrate functionality of this API.
+
+
+Reference
+---------
+
+INSTRUCTIONS: Provide list of API memebers divided into sections. Use coresponding **.. doxygen** directices, so member documentation is auto updated.
+
+* Data Structures **.. doxygenstruct**
+* Macros **.. doxygendefine**
+* Type Definitions **.. doxygentypedef**
+* Enumerations **.. doxygenenum**
+* Functions **.. doxygenfunction**
+* Variables **.. doxygenvariable**
+
+Include code snippotes to ilustrate functionality of particular functions where applicable. Skip section hearder if empty.
+
+
+Data Structures
+^^^^^^^^^^^^^^^
+
+.. Data Structures .. doxygenstruct
+
+Macros
+^^^^^^
+
+.. Macros .. doxygendefine
+
+Type Definitions
+^^^^^^^^^^^^^^^^
+
+.. Type Definitions .. doxygentypedef
+
+Enumerations
+^^^^^^^^^^^^
+
+.. Enumerations .. doxygenenum
+
+Functions
+^^^^^^^^^
+
+.. Functions .. doxygenfunction
+
+Variables
+^^^^^^^^^
+
+.. Variables .. doxygenvariable
+
+

docs/index.rst

@@ -1,5 +1,3 @@
-.. Read the Docs Template documentation master file
-
 ESP32 Programming Guide
 =======================
 
@@ -25,7 +23,7 @@ Contents:
    Eclipse IDE <eclipse-setup>
 
 .. toctree::
-   :caption: Want More?
+   :caption: What Else?
    :maxdepth: 1
    
    partition-tables
@@ -37,8 +35,9 @@ Contents:
    :maxdepth: 1
 
    Wi-Fi <api/esp_wifi>
+   Bluetooth <api/bt>
    GPIO <api/gpio>
-   api/example
+   Template <api/template>
 
 .. toctree::
    :caption: Technical Reference