API template

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

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:*
-
-Configuration of GPIO as an output
+*Example code:* 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
+
+