Added travis ci, tweaked some docs

Author: Sethen Maleno

Diff for: .travis.yml

@@ -0,0 +1,4 @@
+language: node_js
+node_js:
+  - "0.12"
+script: gulp test

Diff for: README.md

@@ -5,9 +5,8 @@
   * [Make a table of contents](#make-a-table-of-contents)
 * [How To Install](#how-to-install)
 * [How To Use From The Command Line](#how-to-use-from-the-command-line)
-  * [markdown.json](#markdownjson)
+  * [markdown.json](#markdown-json)
 * [How To Use As A Module](#how-to-use-as-a-module)
-  * [API](#api)
 * [How It Works](#how-it-works)
 
 
@@ -94,23 +93,6 @@ var markdownInclude = require('markdown-include');
 From there, you can use markdown-include's API to fit your needs.
 
 
-## API
-
-When using as a module, markdown-include offers an API for you to work with markdown files as detailed below:
-
-### `buildLinkString(str)`
-
-```javascript
-var markdownInclude = require('markdown-include');
-markdownInclude.buildLinkString("My Link String"); // my-link-string
-```
-
-| Parameter(s)    | Type     | Returns  | Description                                                            |
-|:---------------:|:--------:|:---------|:----------------------------------------------------------------------:|
-| `string`        | `String` | `String` | File path of where everything should be compiled, like `README.md`.    |
-
----
-
 # How It Works
 
 markdown-include works by recursively going through files based on the tags that are found.  For instance, consider the following in a `_README.md` file:

Diff for: docs/_README.md

@@ -3,5 +3,4 @@
 #include "docs/how_to_use_command_line.md"
 #include "docs/markdown-json.md"
 #include "docs/how_to_use_module.md"
-#include "docs/api.md"
 #include "docs/how_it_works.md"

Diff for: docs/api.md

@@ -4,13 +4,39 @@ When using as a module, markdown-include offers an API for you to work with mark
 
 ### `buildLinkString(str)`
 
+| Parameter(s)    | Type     | Returns  | Description                                                            |
+|:---------------:|:--------:|:---------|:----------------------------------------------------------------------:|
+| `string`        | `String` | `String` | File path of where everything should be compiled, like `README.md`.    |
+
+#### Description
+
+A method for taking strings and building friendly markdown links.  This is mostly used internally for building the table of contents.
+
+#### Example
+
 ```javascript
 var markdownInclude = require('markdown-include');
 markdownInclude.buildLinkString("My Link String"); // my-link-string
 ```
 
-| Parameter(s)    | Type     | Returns  | Description                                                            |
-|:---------------:|:--------:|:---------|:----------------------------------------------------------------------:|
-| `string`        | `String` | `String` | File path of where everything should be compiled, like `README.md`.    |
-
 ---
+
+### `compileFiles(path)`
+
+| Parameter(s)   | Type     | Returns   | Description                                                            |
+|:--------------:|:--------:|:------------------|:----------------------------------------------------------------------:|
+| `path`        | `String` | `Object (Promise)` | Compiles files when given the path to `markdown.json`    |
+
+#### Description
+
+This is probably the most important method in markdown-include.  It takes a path to your markdown.json file, reads your options and returns a promise.  When the promise is resolved it returns the data to you.  This is exactly the same as running markdown-include in the command line as it runs through the whole lifecycle.
+
+#### Example
+
+```javascript
+var markdownInclude = require('markdown-include');
+markdownInclude.compileFiles("path/to/markdown.json").then(function (data) {
+	// do something with compiled files
+});
+```
+