diff --git a/docIndex.md b/docIndex.md
index 281a85a7db..0df74851dc 100644
--- a/docIndex.md
+++ b/docIndex.md
@@ -267,25 +267,25 @@ for more information about installing and using the source code.
## ng2-activiti-tasklist
-Contains the Tasklist omponent and other related items. See the library's
+Contains the Tasklist component and other related items. See the library's
[README file](ng2-components/ng2-activiti-tasklist/README.md)
for more information about installing and using the source code.
-
+
**Documented**
-- [Tasklist component](ng2-components/ng2-activiti-tasklist/README.md)
-- [Task details component](ng2-components/ng2-activiti-tasklist/README.md)
-- [Apps list component](ng2-components/ng2-activiti-tasklist/README.md)
-- [Task filters component](ng2-components/ng2-activiti-tasklist/README.md)
-- [Checklist component](ng2-components/ng2-activiti-tasklist/README.md)
-- [Task attachment list component](ng2-components/ng2-activiti-tasklist/README.md)
-- [Create task attachment component](ng2-components/ng2-activiti-tasklist/README.md)
-- [Task header component](ng2-components/ng2-activiti-tasklist/README.md)
-- [People component](ng2-components/ng2-activiti-tasklist/README.md)
-- [Comments component](ng2-components/ng2-activiti-tasklist/README.md)
-- [People search component](ng2-components/ng2-activiti-tasklist/README.md)
-- [Task audit directive](ng2-components/ng2-activiti-tasklist/README.md)
+- [Apps list component](docs/apps-list.component.md)
+- [Checklist component](docs/checklist.component.md)
+- [Comments component](docs/comments.component.md)
+- [Create task attachment component](docs/create-task-attachment.component.md)
+- [People search component](docs/people-search.component.md)
+- [People component](docs/people.component.md)
+- [Task attachment list component](docs/task-attachment-list.component.md)
+- [Task audit directive](docs/task-audit.directive.md)
+- [Task details component](docs/task-details.component.md)
+- [Task filters component](docs/task-filters.component.md)
+- [Task header component](docs/task-header.component.md)
+- [Tasklist component](docs/tasklist.component.md)
**Undocumented**
diff --git a/docassets/images/activiti_people.png b/docassets/images/activiti_people.png
new file mode 100644
index 0000000000..42c7c41728
Binary files /dev/null and b/docassets/images/activiti_people.png differ
diff --git a/docassets/images/adf-comments.png b/docassets/images/adf-comments.png
new file mode 100644
index 0000000000..40a31a3c4d
Binary files /dev/null and b/docassets/images/adf-comments.png differ
diff --git a/docassets/images/adf-task-audit-directive.png b/docassets/images/adf-task-audit-directive.png
new file mode 100644
index 0000000000..acf07e2c4a
Binary files /dev/null and b/docassets/images/adf-task-audit-directive.png differ
diff --git a/docassets/images/adf-task-header.png b/docassets/images/adf-task-header.png
new file mode 100644
index 0000000000..41ed32afb9
Binary files /dev/null and b/docassets/images/adf-task-header.png differ
diff --git a/docassets/images/how-filter-apps.png b/docassets/images/how-filter-apps.png
new file mode 100644
index 0000000000..e50e4f57e1
Binary files /dev/null and b/docassets/images/how-filter-apps.png differ
diff --git a/docassets/images/how-to-create-accordion-menu.png b/docassets/images/how-to-create-accordion-menu.png
new file mode 100644
index 0000000000..94721a4e2c
Binary files /dev/null and b/docassets/images/how-to-create-accordion-menu.png differ
diff --git a/docassets/images/involve-people-double-click-and-close-search.gif b/docassets/images/involve-people-double-click-and-close-search.gif
new file mode 100644
index 0000000000..310e36ff97
Binary files /dev/null and b/docassets/images/involve-people-double-click-and-close-search.gif differ
diff --git a/docassets/images/involve-people-double-click-without-close-search.gif b/docassets/images/involve-people-double-click-without-close-search.gif
new file mode 100644
index 0000000000..54c03c256c
Binary files /dev/null and b/docassets/images/involve-people-double-click-without-close-search.gif differ
diff --git a/docassets/images/involve-people-single-click-and-close-search.gif b/docassets/images/involve-people-single-click-and-close-search.gif
new file mode 100644
index 0000000000..e3300f5c1f
Binary files /dev/null and b/docassets/images/involve-people-single-click-and-close-search.gif differ
diff --git a/docassets/images/involve-people-single-click-without-close-search.gif b/docassets/images/involve-people-single-click-without-close-search.gif
new file mode 100644
index 0000000000..8e40815a01
Binary files /dev/null and b/docassets/images/involve-people-single-click-without-close-search.gif differ
diff --git a/docassets/images/task-attachment-list.png b/docassets/images/task-attachment-list.png
new file mode 100644
index 0000000000..23d902bfb4
Binary files /dev/null and b/docassets/images/task-attachment-list.png differ
diff --git a/docassets/images/task-create-attachment.png b/docassets/images/task-create-attachment.png
new file mode 100644
index 0000000000..f755633f7c
Binary files /dev/null and b/docassets/images/task-create-attachment.png differ
diff --git a/docs/apps-list.component.md b/docs/apps-list.component.md
new file mode 100644
index 0000000000..dde5b5d121
--- /dev/null
+++ b/docs/apps-list.component.md
@@ -0,0 +1,70 @@
+# Activiti Apps Component
+
+Shows all available apps.
+
+
+
+
+
+- [Basic Usage](#basic-usage)
+ * [Properties](#properties)
+ * [Events](#events)
+- [Details](#details)
+ * [How filter the activiti apps](#how-filter-the-activiti-apps)
+
+
+
+
+
+## Basic Usage
+
+```html
+
+
+```
+
+### Properties
+
+| Name | Type | Description |
+| --- | --- | --- |
+| layoutType | string | (**required**) Define the layout of the apps. There are two possible values: GRID or LIST. |
+| filtersAppId | Object | Provide a way to filter the apps to show. |
+
+### Events
+
+| Name | Description |
+| --- | --- |
+| appClick | Raised when an app entry is clicked |
+
+## Details
+
+### How filter the activiti apps
+
+If you want to show some specific apps you can specify them through the filtersAppId parameters
+
+```html
+
+
+```
+
+In this specific case only the Tasks app, the app with deploymentId 15037 and the app with "my app name" will be shown.
+
+
+
+You can use inside the filter one of the following property
+
+```json
+{
+ "defaultAppId": "string",
+ "deploymentId": "string",
+ "name": "string",
+ "id": "number",
+ "modelId": "number",
+ "tenantId": "number"
+}
+```
\ No newline at end of file
diff --git a/docs/checklist.component.md b/docs/checklist.component.md
new file mode 100644
index 0000000000..313a535321
--- /dev/null
+++ b/docs/checklist.component.md
@@ -0,0 +1,32 @@
+# Activiti Checklist Component
+
+Shows the checklist task functionality.
+
+
+
+
+
+- [Basic Usage](#basic-usage)
+ * [Properties](#properties)
+
+
+
+
+
+## Basic Usage
+
+```html
+
+```
+
+### Properties
+
+| Name | Type | Description |
+| --- | --- | --- |
+| taskId | string | (**required**) The id of the parent task which sub tasks are attached on. |
+| readOnlyForm | boolean | Toggle readonly state of the form. Enforces all form widgets render readonly if enabled. |
+| assignee | string | (**required**) The assignee id where the subtasks are assigned to. |
diff --git a/docs/comments.component.md b/docs/comments.component.md
new file mode 100644
index 0000000000..2ceea367f5
--- /dev/null
+++ b/docs/comments.component.md
@@ -0,0 +1,39 @@
+# ADF Comments Component
+
+Displays comments from users involved in a specified task and allows an involved user to add a comment to the task.
+
+
+
+
+
+
+
+- [Basic Usage](#basic-usage)
+ * [Properties](#properties)
+ * [Events](#events)
+
+
+
+
+
+## Basic Usage
+
+```html
+
+
+```
+
+### Properties
+
+| Name | Type | Description |
+| --- | --- | --- |
+| taskId | string | The numeric ID of the task |
+| readOnly | boolean | The boolean flag |
+
+### Events
+
+| Name | Description |
+| --- | --- |
+| error | Raised when an error occurs while displaying/adding a comment |
diff --git a/docs/create-task-attachment.component.md b/docs/create-task-attachment.component.md
new file mode 100644
index 0000000000..7dfc48cd5f
--- /dev/null
+++ b/docs/create-task-attachment.component.md
@@ -0,0 +1,40 @@
+# Create Task Attachment Component
+
+Displays Upload Component(Drag and Click) to upload the attachment to a specified task
+
+
+
+
+
+
+
+- [Basic Usage](#basic-usage)
+ * [Properties](#properties)
+ * [Events](#events)
+
+
+
+
+
+## Basic Usage
+
+```html
+
+
+```
+
+### Properties
+
+| Name | Type | Description |
+| --- | --- | --- |
+| taskId | string | (**required**): The numeric ID of the task to display |
+
+### Events
+
+| Name | Description |
+| --- | --- |
+| error | Raised when the error occurred while creating/uploading the attachment by the user from within the component |
+| success | Raised when the attachment created/uploaded successfully from within the component |
diff --git a/docs/people-search.component.md b/docs/people-search.component.md
new file mode 100644
index 0000000000..1e31cb4f3d
--- /dev/null
+++ b/docs/people-search.component.md
@@ -0,0 +1,50 @@
+# People Search component
+
+Searches users/people.
+
+
+
+
+
+- [Basic Usage](#basic-usage)
+ * [Properties](#properties)
+ * [Events](#events)
+- [Details](#details)
+
+
+
+
+
+## Basic Usage
+
+```html
+
+```
+
+### Properties
+
+| Name | Type | Description |
+| --- | --- | --- |
+| results | Observable | The params to show people list |
+
+### Events
+
+| Name | Description |
+| --- | --- |
+| searchPeople | Raised when the search people with new keyword |
+| success | Raised when select the user and click action button |
+| closeSearch | Raised when click the clse button |
+
+## Details
+
+ ```html
+
+ {{ 'TASK_DETAILS.LABELS.ADD_PEOPLE' | translate }}
+ {{ 'PEOPLE.ADD_USER' | translate }}
+
+
+```
diff --git a/docs/people.component.md b/docs/people.component.md
new file mode 100644
index 0000000000..78f625e9c7
--- /dev/null
+++ b/docs/people.component.md
@@ -0,0 +1,107 @@
+# Task People Component
+
+Displays involved users to a specified task
+
+
+
+
+
+- [Basic Usage](#basic-usage)
+ * [Properties](#properties)
+ * [Events](#events)
+- [Details](#details)
+ * [How to customize the people component behavior](#how-to-customize-the-people-component-behavior)
+ * [Involve People single click and close search](#involve-people-single-click-and-close-search)
+ * [Involve People single click without close search](#involve-people-single-click-without-close-search)
+ * [Involve People double click and close search](#involve-people-double-click-and-close-search)
+ * [Involve People double double without close search](#involve-people-double-double-without-close-search)
+
+
+
+
+
+## Basic Usage
+
+```html
+
+
+```
+
+
+
+### Properties
+
+| Name | Type | Description |
+| --- | --- | --- |
+| people | User[] | The array of User object to display |
+| taskId | string | The numeric ID of the task |
+| readOnly | boolean | The boolean flag |
+
+### Events
+
+No Events
+
+## Details
+
+### How to customize the people component behavior
+
+The people component provide two methods to customize the behavior:
+- involveUserAndCloseSearch: The selected user is going to be added and the search section closed
+- involveUserWithoutCloseSearch: The selected user is going to be added without close the search section
+
+In this way will be easy customize the people component to involve the user with the single or double click event:
+
+### Involve People single click and close search
+
+```html
+
+
+```
+
+
+
+### Involve People single click without close search
+
+```html
+
+
+```
+
+
+
+### Involve People double click and close search
+
+```html
+
+
+```
+
+
+
+### Involve People double double without close search
+
+```html
+
+
+```
+
+
diff --git a/docs/task-attachment-list.component.md b/docs/task-attachment-list.component.md
new file mode 100644
index 0000000000..4c6d7c9969
--- /dev/null
+++ b/docs/task-attachment-list.component.md
@@ -0,0 +1,41 @@
+# Task Attachment List Component
+
+Displays attached documents on a specified task
+
+
+
+
+
+
+
+- [Basic Usage](#basic-usage)
+ * [Properties](#properties)
+ * [Events](#events)
+
+
+
+
+
+## Basic Usage
+
+```html
+
+
+```
+
+### Properties
+
+| Name | Type | Description |
+| --- | --- | --- |
+| taskId | string | (**required**): The ID of the task to display |
+| disabled | boolean | false | Disable/Enable read only mode for attachement list |
+
+### Events
+
+| Name | Description |
+| --- | --- |
+| attachmentClick | Raised when the attachment double clicked or selected view option from context menu by the user from within the component and return a Blob obj of the object clicker|
+| success | Raised when the attachment list fetch all the attach and return a list of attachments |
+| error | Raised when the attachment list is not able to fetch the attachments for example network error |
diff --git a/docs/task-audit.directive.md b/docs/task-audit.directive.md
new file mode 100644
index 0000000000..3dffe79563
--- /dev/null
+++ b/docs/task-audit.directive.md
@@ -0,0 +1,45 @@
+# Task Audit Directive
+
+Provides a way to fetch the Task Audit information in the pdf or json format.
+
+
+
+
+
+
+
+- [Basic Usage](#basic-usage)
+ * [Properties](#properties)
+ * [Events](#events)
+
+
+
+
+
+## Basic Usage
+
+```html
+
+```
+
+### Properties
+
+| Name | Type | Default | Description |
+| --- | --- | --- | --- |
+| taskId | string | | (**required**) The id of the task. |
+| format | string | pdf | In whitch format you want the task audit information (pdf or json). |
+| download | boolean | false | True If you want download the file on the click event. |
+| fileName | string | Audit | Represent the name of the file to download in case the format is pdf. |
+
+### Events
+
+| Name | Description |
+| --- | --- |
+| clicked | Raised when the task audit info is ready |
+| error | Raised if there is an error during fetching task information |
diff --git a/docs/task-details.component.md b/docs/task-details.component.md
new file mode 100644
index 0000000000..ae49a202cc
--- /dev/null
+++ b/docs/task-details.component.md
@@ -0,0 +1,80 @@
+# Activiti Task Details component
+
+Shows the details of the task id passed in input
+
+
+
+
+
+- [Basic Usage](#basic-usage)
+ * [Properties](#properties)
+ * [Events](#events)
+- [Details](#details)
+ * [Custom 'empty Activiti Task Details' template](#custom-empty-activiti-task-details-template)
+
+
+
+
+
+## Basic Usage
+
+```html
+
+
+```
+
+### Properties
+
+| Name | Type | Default | Description |
+| --- | --- | --- | --- |
+| taskId | string | | (**required**) The id of the task details that we are asking for. |
+| showNextTask | boolean | true | Automatically render the next one, when the task is completed. |
+| showFormTitle | boolean | true | Toggle rendering of the form title. |
+| readOnlyForm | boolean | false | Toggle readonly state of the form. Enforces all form widgets render readonly if enabled. |
+| showFormRefreshButton | boolean | true | Toggle rendering of the `Refresh` button. |
+| showFormSaveButton | boolean | true| Toggle rendering of the `Save` outcome button. |
+| showFormCompleteButton | boolean | true | Toggle rendering of the Form `Complete` outcome button |
+| peopleIconImageUrl | string | | Define a custom people icon image |
+| showHeader | boolean | true | Toggle task details Header component |
+| showHeaderContent | boolean | true | Toggle collapsed/expanded state of the Header component |
+| showInvolvePeople | boolean | true | Toggle `Involve People` feature for Header component |
+| showComments | boolean | true | Toggle `Comments` feature for Header component |
+| showChecklist | boolean | true | Toggle `Checklist` feature for Header component |
+| fieldValidators | FormFieldValidator[] | [] | Field validators for use with the form. |
+
+### Events
+
+| Name | Description |
+| --- | --- |
+| formLoaded | Raised when form is loaded or reloaded. |
+| formSaved | Raised when form is submitted with `Save` or custom outcomes. |
+| formCompleted | Raised when form is submitted with `Complete` outcome. |
+| taskCreated | Raised when a checklist task is created. |
+| executeOutcome | Raised when any outcome is executed, default behaviour can be prevented via `event.preventDefault()` |
+| onError | Raised at any error |
+
+## Details
+
+### Custom 'empty Activiti Task Details' template
+
+By default the Activiti Task Details provides the following message for the empty task details:
+
+```html
+No Tasks
+```
+
+This can be changed by adding the following custom html template:
+
+```html
+
+
+
+
Sorry, no tasks here
+
+
+
+
+```
+
+Note that can put any HTML content as part of the template, including other Angular components.
diff --git a/docs/task-filters.component.md b/docs/task-filters.component.md
new file mode 100644
index 0000000000..6ee07c82da
--- /dev/null
+++ b/docs/task-filters.component.md
@@ -0,0 +1,94 @@
+# Activiti Filter component
+
+Shows all available filters.
+
+
+
+
+
+- [Basic Usage](#basic-usage)
+ * [Properties](#properties)
+ * [Events](#events)
+- [Details](#details)
+ * [How filter the activiti task filters](#how-filter-the-activiti-task-filters)
+ * [FilterParamsModel](#filterparamsmodel)
+ * [How to create an accordion menu with the task filter](#how-to-create-an-accordion-menu-with-the-task-filter)
+
+
+
+
+
+## Basic Usage
+
+```html
+
+```
+
+### Properties
+
+| Name | Type | Description |
+| --- | --- | --- |
+| filterParam | [FilterParamsModel](#filterparamsmodel) | The params to filter the task filter. If there is no match the default one (first filter of the list) is selected |
+| appId | string | Display filters available to the current user for the application with the specified ID. |
+| `appName` | string | Display filters available to the current user for the application with the specified name. |
+| `hasIcon` | boolean | Toggle to show or not the filter's icon. |
+
+If both `appId` and `appName` are specified then `appName` will take precedence and `appId` will be ignored.
+
+### Events
+
+| Name | Description |
+| --- | --- |
+| filterClick | Raised when the filter in the list is clicked |
+| onSuccess | Raised when the list is loaded |
+| onError | Raised if there is an error during the loading |
+
+## Details
+
+### How filter the activiti task filters
+
+ ```html
+
+
+
+```
+
+You can use inside the filterParam one of the properties from [FilterParamsModel](#filterparamsmodel) (see below).
+
+### FilterParamsModel
+
+```json
+{
+ "id": "number",
+ "name": "string",
+ "index": "number"
+}
+```
+
+| Name | Type | Description |
+| --- | --- | --- |
+| id | string | The id of the task filter |
+| name | string | The name of the task filter, lowercase is checked |
+| index | string | The zero-based position of the filter in the array. |
+
+### How to create an accordion menu with the task filter
+
+You can create an accordion menu using the AccordionComponent that wrap the activiti task filter.
+The AccordionComponent is exposed by the alfresco-core.
+
+```html
+
+
+
+
+
+
+```
+
+
diff --git a/docs/task-header.component.md b/docs/task-header.component.md
new file mode 100644
index 0000000000..47e113268c
--- /dev/null
+++ b/docs/task-header.component.md
@@ -0,0 +1,43 @@
+# Activiti Task Header component
+
+Shows all the information related to a task.
+
+
+
+
+
+
+
+- [Basic Usage](#basic-usage)
+ * [Properties](#properties)
+ * [Events](#events)
+- [Details](#details)
+
+
+
+
+
+## Basic Usage
+
+```html
+
+
+```
+
+### Properties
+
+| Name | Type | Default | Description |
+| --- | --- | --- | --- |
+| taskDetails | [TaskDetailsModel](#taskdetailsmodel) | | (**required**) The task details related to the task. |
+| formName | string | | The name of the form. |
+
+### Events
+
+| Name | Description |
+| --- | --- |
+| claim | Raised when the task is claimed. |
+
+## Details
+
+The purpose of the component is to populate the local variable called `properties` (array of CardViewModel), with all the information that we want to display.
diff --git a/docs/tasklist.component.md b/docs/tasklist.component.md
new file mode 100644
index 0000000000..fd661b4449
--- /dev/null
+++ b/docs/tasklist.component.md
@@ -0,0 +1,82 @@
+# Activiti Task List component
+
+Renders a list containing all the tasks matched by the parameters specified.
+
+
+
+
+
+- [Basic Usage](#basic-usage)
+ * [Properties](#properties)
+ * [Events](#events)
+- [Details](#details)
+ * [DataTableAdapter example](#datatableadapter-example)
+ * [DataColumn Features](#datacolumn-features)
+
+
+
+
+
+## Basic Usage
+
+```html
+
+
+```
+
+You can also use HTML-based schema declaration like shown below:
+
+```html
+
+
+
+
+
+
+```
+
+### Properties
+
+| Name | Type | Default | Description |
+| --- | --- | --- | --- |
+| appId | string || The id of the app. |
+| processDefinitionKey | string || The processDefinitionKey of the process. |
+| processInstanceId | string || The processInstanceId of the process. |
+| page | number | 0 | The page of the tasks to fetch. |
+| size | number | 5 | The number of tasks to fetch. |
+| assignment | string || The assignment of the process.
Possible values are:
assignee : where the current user is the assignee
candidate: where the current user is a task candidate
group_x: where the task is assigned to a group where the current user is a member of.
no value: where the current user is involved
|
+| state | string || Define state of the processes. Possible values are: `completed`, `active` |
+| hasIcon | boolean | true | Toggle the icon on the left . |
+| landingTaskId | string | | Define which task id should be selected after the reloading. If the task id doesn't exist or nothing is passed it will select the first task |
+| sort | string | | Define the sort of the processes. Possible values are : `created-desc`, `created-asc`, `due-desc`, `due-asc` |
+| data | DataTableAdapter | | JSON object that represent the number and the type of the columns that you want show (see the [example](#datatableadapter-example) section below) |
+
+### Events
+
+| Name | Description |
+| --- | --- |
+| onSuccess | Raised when the task list is loaded |
+| rowClick | Raised when the task in the list is clicked |
+
+## Details
+
+This component displays lists of process instances both active and completed, using any defined process filter, and
+render details of any chosen instance.
+
+### DataTableAdapter example
+
+```json
+[
+ {"type": "text", "key": "id", "title": "Id"},
+ {"type": "text", "key": "name", "title": "Name", "cssClass": "full-width name-column", "sortable": true},
+ {"type": "text", "key": "formKey", "title": "Form Key", "sortable": true},
+ {"type": "text", "key": "created", "title": "Created", "sortable": true}
+]
+```
+
+### DataColumn Features
+
+You can customize the styling of a column and also add features like tooltips and automatic translation of column titles. See the DataColumn docs for more information about these features.
\ No newline at end of file
+
+