updating doc

Author: marcelog

README.md

@@ -15,11 +15,11 @@ from a developers' perspective.
 
 Resources:
 
- * [Complete PAGI/PAMI talk for the PHP Conference Argentina 2013](http://www.slideshare.net/mgornstein/phpconf-2013). Check the slide notes for the complete text :)
  * [Main Site](http://marcelog.github.com/PAGI)
+ * [API](https://github.com/marcelog/PAGI/blob/master/doc/ApiIndex.md)
+ * [Complete PAGI/PAMI talk for the PHP Conference Argentina 2013](http://www.slideshare.net/mgornstein/phpconf-2013). Check the slide notes for the complete text :)
  * [In-depth tutorial](http://marcelog.github.com/articles/pagi_tutorial_create_voip_telephony_application_for_asterisk_with_agi_and_php.html)
  * [An example IVR application that includes unit tests is available here](https://github.com/marcelog/Pagi-App-And-Test-Example)
- * [API](http://ci.marcelog.name:8080/job/PAGI/javadoc/)
  * [Professional Telephony Applications at hand](http://sdjournal.org/a-practical-introduction-to-functional-programming-with-php-sdj-issue-released/) The march edition of [Software Developer Journal](http://sdjournal.org/) features a complete article about writing telephony applications with PAMI and PAGI.
 
 # Installing
@@ -31,13 +31,7 @@ composer.json:
   }
 ```
 
-# Documentation
-
-  * Autogenerated documentation for this source can be found in the [doc](https://github.com/marcelog/PAGI/blob/master/doc/ApiIndex.md) directory.
-  * Some usage examples can be found in the [doc/examples](https://github.com/marcelog/PAGI/blob/master/doc/examples) directory.
-
-# Included Examples
-Please see **docs/examples** for all the included examples.
+# Quickstart
 
 You can start by *docs/examples/quickstart* for a very basic example. You'll need something like this in your dialplan:
 
@@ -50,7 +44,9 @@ You can start by *docs/examples/quickstart* for a very basic example. You'll nee
 A mocked pagi client is included to easily test your ivr applications. See
 **docs/examples/mock** to see an example of how to use it.
 
-# Nodes
+# Features
+
+## Nodes
 
 For a tutorial about nodes, see [this article](http://marcelog.github.com/articles/pagi_node_call_flow_easy_telephony_application_for_asterisk_php.html)
 
@@ -79,16 +75,16 @@ callback, etc. For an example, see docs/examples/nodecontroller/example.php
 
 An article about the node controller is available [here](http://marcelog.github.com/articles/making_your_ivr_nodes_call_flow_with_pagi_and_php_asterisk.html)
 
-# AutoDial
+## AutoDial
 
 CallFiles are supported. You can also schedule a call in the future.
 
-# Fax
+## Fax
 
 Sending and receiving faxes is supported using spandsp (applications SendFax
 and ReceiveFax).
 
-# Available Facades
+## Available Facades
 
  * PAGI\Client\CDR: Provided to access cdr variables.
  * PAGI\Client\ChannelVariables: Provided to access channel variables and asterisk
@@ -100,7 +96,7 @@ environment variables.
  * PAGI\Logger\Asterisk: Provides access to asterisk logger (see logger.conf in
 your asterisk installation).
 
-# Results
+## Results
 
 For every operation, a Result is provided. Some operations decorate this
 Result to add functionality, like PlayResult, ReadResult, etc. For example,
@@ -113,7 +109,7 @@ in turn, decorated a Result.
   * PAGI\Client\PlayResult
   * PAGI\Client\FaxResult
 
-# Debugging, logging
+## Debugging, logging
 
 You can optionally set a [PSR-3](http://www.php-fig.org/psr/psr-3/) compatible logger:
 ```php