From 74475dbd424c247a8ae9b6d23afe1f2e1e7728d5 Mon Sep 17 00:00:00 2001
From: Andy Stark <30621568+therealandeeee@users.noreply.github.com>
Date: Thu, 17 Jan 2019 17:21:23 +0000
Subject: [PATCH] [ADF-3745] Fixed links in rel notes, tutorials and guide
 (#4179)

---
 docs/release-notes/RelNote170.md              |  8 ++--
 docs/release-notes/RelNote190.md              |  2 +-
 docs/release-notes/RelNote200.md              | 25 ++++++------
 docs/release-notes/RelNote210.md              | 12 +++---
 docs/release-notes/RelNote220.md              |  4 +-
 docs/release-notes/RelNote230.md              | 14 +++----
 docs/release-notes/RelNote240.md              |  8 ++--
 docs/release-notes/RelNote250.md              |  4 +-
 docs/release-notes/RelNote260.md              | 38 +++++++++----------
 docs/tutorials/README.md                      | 20 +++++-----
 docs/tutorials/basic-theming.md               |  4 +-
 docs/tutorials/content-metadata-component.md  |  4 +-
 ...ng-javascript-app-using-alfresco-js-api.md | 12 +++---
 .../creating-the-app-using-yeoman.md          |  4 +-
 docs/tutorials/customising-login.md           | 16 ++++----
 docs/tutorials/new-component.md               |  4 +-
 docs/tutorials/new-view.md                    |  4 +-
 docs/tutorials/preparing-environment.md       | 22 ++++++-----
 docs/tutorials/working-with-data-table.md     | 14 ++++---
 docs/tutorials/working-with-nodes-js-api.md   |  4 +-
 docs/user-guide/README.md                     |  1 -
 docs/user-guide/angular-material-design.md    |  2 +
 docs/user-guide/app-extensions.md             |  6 +--
 docs/user-guide/extensibility.md              |  2 +
 docs/user-guide/internationalization.md       | 14 ++++---
 docs/user-guide/metadata-indicators.md        |  6 +--
 docs/user-guide/theming.md                    |  2 +
 docs/user-guide/transclusion.md               |  4 +-
 docs/user-guide/typography.md                 |  4 +-
 29 files changed, 146 insertions(+), 118 deletions(-)

diff --git a/docs/release-notes/RelNote170.md b/docs/release-notes/RelNote170.md
index 4b3614a8b4..e97ff19ed2 100644
--- a/docs/release-notes/RelNote170.md
+++ b/docs/release-notes/RelNote170.md
@@ -246,8 +246,8 @@ Two new methods has been added into the alfresco-js-api to support retrieve the
 
 | API | Name | HTTP method | URL | Description |
 | --- | ---- | ----------- | --- | ----------- |
-| _ActivitiPublicRestApi.TaskApi_ | [**getTaskAuditJson**](https://github.com/Alfresco/alfresco-js-api/blob/a82ce3bbe56cb0944f8771d14193704b571adf96/src/alfresco-activiti-rest-api/docs/TaskApi.md#getTaskAuditJson) | **GET**  | /api/enterprise/tasks/{taskId}/audit | Retrieve audit infromation in json format |
-| _ActivitiPublicRestApi.TaskApi_ | [**getTaskAuditPdf**](https://github.com/Alfresco/alfresco-js-api/blob/a82ce3bbe56cb0944f8771d14193704b571adf96/src/alfresco-activiti-rest-api/docs/TaskApi.md#getTaskAuditPdf) | **GET**  | /app/rest/tasks/{taskId}/audit | Retrieve the task audit infromation in pdf format |
+| _ActivitiPublicRestApi.TaskApi_ | [**getTaskAuditJson**](https://github.com/Alfresco/alfresco-js-api/blob/a82ce3bbe56cb0944f8771d14193704b571adf96/src/alfresco-activiti-rest-api/docs/TaskApi.md#getTaskAuditJson) | **GET** | /api/enterprise/tasks/{taskId}/audit | Retrieve audit infromation in json format |
+| _ActivitiPublicRestApi.TaskApi_ | [**getTaskAuditPdf**](https://github.com/Alfresco/alfresco-js-api/blob/a82ce3bbe56cb0944f8771d14193704b571adf96/src/alfresco-activiti-rest-api/docs/TaskApi.md#getTaskAuditPdf) | **GET** | /app/rest/tasks/{taskId}/audit | Retrieve the task audit infromation in pdf format |
 
 For further details about those endepoints please refer to the [official documentation](https://github.com/Alfresco/alfresco-js-api/blob/master/src/alfresco-activiti-rest-api/docs/TaskApi.md) 
 
@@ -264,7 +264,7 @@ The list below is the list of the new services added in 1.7.0:
 -   [`SharedLinksApiService`](../core/shared-links-api.service.md)
 -   SitesApiService
 -   [`ThumbnailService`](../core/thumbnail.service.md)
--   [`SearchService`](../../lib/core/services/search.service.ts)
+-   [`SearchService`](../core/search.service.md)
 
 ### 18. Code Contribution Guide and CLA
 
@@ -379,7 +379,7 @@ Release Notes - Apps Development Framework - Version 1.7.
 -   \[[ADF-1169](https://issues.alfresco.com/jira/browse/ADF-1169)] - [Start Task] - Missing date validation
 -   \[[ADF-1175](https://issues.alfresco.com/jira/browse/ADF-1175)] - Start Process and Start Task Forms don't close when Cancel button is clicked
 -   \[[ADF-1190](https://issues.alfresco.com/jira/browse/ADF-1190)] - Task form - Unable to view task form when the process does not have variables
--   \[[ADF-1199](https://issues.alfresco.com/jira/browse/ADF-1199)] - [`MinimalNodeEntryEntity`](../content-services/document-library.model.md) is missing the "allowableOperations" property
+-   \[[ADF-1199](https://issues.alfresco.com/jira/browse/ADF-1199)] - `MinimalNodeEntryEntity` is missing the "allowableOperations" property
 -   \[[ADF-1200](https://issues.alfresco.com/jira/browse/ADF-1200)] - The URL validation error message is still displayed after changing the invalid url with a valid one
 -   \[[ADF-1201](https://issues.alfresco.com/jira/browse/ADF-1201)] - 508 Compliance Resolution for the App tiles. - 2131 Github
 -   \[[ADF-1216](https://issues.alfresco.com/jira/browse/ADF-1216)] - The included packages are not displayed in [About Component](../core/about.component.md) if the user is logged only on Content Services
diff --git a/docs/release-notes/RelNote190.md b/docs/release-notes/RelNote190.md
index 326e4691d7..b897b9a41b 100644
--- a/docs/release-notes/RelNote190.md
+++ b/docs/release-notes/RelNote190.md
@@ -350,7 +350,7 @@ Release Notes - Apps Development Framework - Version 1.9.
 -   \[[ADF-1249](https://issues.alfresco.com/jira/browse/ADF-1249)] - Remove mdl from ng2-activiti-diagrams
 -   \[[ADF-1250](https://issues.alfresco.com/jira/browse/ADF-1250)] - Remove mdl from ng2-activiti-analytics
 -   \[[ADF-1251](https://issues.alfresco.com/jira/browse/ADF-1251)] - Remove mdl from demo shell
--   \[[ADF-1492](https://issues.alfresco.com/jira/browse/ADF-1492)] - Document List - Export [`ContentNodeSelectorComponent`](../content-services/content-node-selector.component.md) and ContentNodeSelectorComponentData
+-   \[[ADF-1492](https://issues.alfresco.com/jira/browse/ADF-1492)] - Document List - Export [`ContentNodeSelectorComponent`](../content-services/content-node-selector.component.md) and [ContentNodeSelectorComponentData](../../lib/content-services/content-node-selector/content-node-selector.component-data.interface.ts)
 -   \[[ADF-1496](https://issues.alfresco.com/jira/browse/ADF-1496)] - Remove "Disable upload button when user has no permissions" switch.
 -   \[[ADF-1504](https://issues.alfresco.com/jira/browse/ADF-1504)] - Rename UserInfoComponentModule to [`UserInfoModule`](../../lib/core/userinfo/userinfo.module.ts)
 -   \[[ADF-1515](https://issues.alfresco.com/jira/browse/ADF-1515)] - Internationalization - ADF strings review
diff --git a/docs/release-notes/RelNote200.md b/docs/release-notes/RelNote200.md
index 5989f36240..2e90cbb1d1 100644
--- a/docs/release-notes/RelNote200.md
+++ b/docs/release-notes/RelNote200.md
@@ -69,7 +69,8 @@ Please note the only major version valid for the package @alfresco/adf-insights
 While this release had a high focus on stabilization and bug fixes, we have also introduced new and enhanced features. These include a completely revamped [Viewer component,](../core/viewer.component.md) a new metadata component and file versioning. Also, ADF is now localized into 11 different languages. In total we have closed around 242 issues in JIRA.
 
 Since we follow [SEMVER](https://semver.org), we can only introduce breaking changes in major releases. We learned a lot and we needed to restructure and rename components to make things easier moving forward. You can see all the details about the breaking changes below.
-We have continued to expand and rewrite our documentation. We now have a [new component catalog](https://alfresco.github.io/adf-component-catalog/) running that we hope you'll enjoy.
+We have continued to expand and rewrite our documentation. We now have a new component catalog
+running that we hope you'll enjoy.
 
 The Yeoman generators have been updated. We now ship three small [Angular CLI](https://cli.angular.io)
 based applications to help get you started.
@@ -231,7 +232,7 @@ For more details please refer to [Upload button documentation](../content-servic
 
 ### 8. Register Alfresco file type icons within the mat-icon
 
-All the ADF MIME type icons are now registered into the MatIconRegistry. This improvement allows you to use all the icons through the mat-icon tag:
+All the ADF MIME type icons are now registered into the [MatIconRegistry](https://material.angular.io/components/icon/api). This improvement allows you to use all the icons through the mat-icon tag:
 
 ![](images/Untitled.gif)
 
@@ -255,7 +256,7 @@ The [log service](../core/log.service.md) provides 6 level of logs: TRACE, DEBUG
 
 ### 10. Favorite node directive
 
-The NodeFavoriteDirective instance can be bound to a button to retrieve and manage a favorites node list:
+The [NodeFavoriteDirective](../core/node-favorite.directive.md) instance can be bound to a button to retrieve and manage a favorites node list:
 
     <button mat-icon-button
             #favorite="adfFavorite"
@@ -475,18 +476,18 @@ The **extension-viewer** tag (used to extend the viewer behavior to open extensi
 
 | Properties | Description |
 | ---------- | ----------- |
-| enabled |  Deprecated in 1.6.0 in favor of disabled input property |
-| showNotificationBar  | Deprecated in 1.6.0 you can use [`UploadService`](../core/upload.service.md) events and [`NotificationService`](../core/notification.service.md) api instead. |
-| currentFolderPath  | Deprecated in 1.6.0, this property is not used for couple of releases already. Use rootFolderId instead. |
-| rootFolderId  | Deprecated in 1.6.0, this property is not used for couple of releases already. Use parentId instead |
+| enabled | Deprecated in 1.6.0 in favor of disabled input property |
+| showNotificationBar | Deprecated in 1.6.0 you can use [`UploadService`](../core/upload.service.md) events and [`NotificationService`](../core/notification.service.md) api instead. |
+| currentFolderPath | Deprecated in 1.6.0, this property is not used for couple of releases already. Use rootFolderId instead. |
+| rootFolderId | Deprecated in 1.6.0, this property is not used for couple of releases already. Use parentId instead |
 
 **adf-upload-button :**
 
 | Properties | Description |
 | ---------- | ----------- |
-| showNotificationBar  | Deprecated in 1.6.0 you can use [`UploadService`](../core/upload.service.md) events and NotificationService api instead. |
-| currentFolderPath  | Deprecated in 1.6.0, this property is not used for couple of releases already. Use rootFolderId instead. |
-| disableWithNoPermission  | Deprecated in 1.8.0, use the button with combination of adf-node-permission directive |
+| showNotificationBar | Deprecated in 1.6.0 you can use [`UploadService`](../core/upload.service.md) events and [NotificationService](../core/notification.service.md) api instead. |
+| currentFolderPath | Deprecated in 1.6.0, this property is not used for couple of releases already. Use rootFolderId instead. |
+| disableWithNoPermission | Deprecated in 1.8.0, use the button with combination of adf-node-permission directive |
 
 ### Internal pagination has been removed from the DocumentList
 
@@ -555,7 +556,7 @@ Below you can find a brief list of references to help you start to use the new r
 
 [Getting started guides with Alfresco Application Development Framework](https://community.alfresco.com/community/application-development-framework/pages/get-started)
 
-[Component catalog](https://alfresco.github.io/adf-component-catalog/)
+Component catalog
 
 [Gitter chat supporting Alfresco ADF](https://gitter.im/Alfresco/alfresco-ng2-components)
 
@@ -583,7 +584,7 @@ Release Notes - Apps Development Framework - Version 2.0.
 -   \[[ADF-1633](https://issues.alfresco.com/jira/browse/ADF-1633)] - [Login] redirect to original path upon successful login
 -   \[[ADF-1694](https://issues.alfresco.com/jira/browse/ADF-1694)] - Date-picker i18n support
 -   \[[ADF-1723](https://issues.alfresco.com/jira/browse/ADF-1723)] - [Service][logservice](../core/log.service.md) configuration
--   \[[ADF-1729](https://issues.alfresco.com/jira/browse/ADF-1729)] - [Directive] Mark Node as Favorite Directive
+-   \[[ADF-1729](https://issues.alfresco.com/jira/browse/ADF-1729)] - [Directive] Mark [Node](https://github.com/Alfresco/alfresco-js-api/blob/development/src/api/content-rest-api/docs/Node.md) as Favorite Directive
 -   \[[ADF-1745](https://issues.alfresco.com/jira/browse/ADF-1745)] - [Directive] Delete multiple nodes directive
 -   \[[ADF-1749](https://issues.alfresco.com/jira/browse/ADF-1749)] - [Task List][process list] - Customizable template using the app.config.json
 -   \[[ADF-1750](https://issues.alfresco.com/jira/browse/ADF-1750)] - [Viewer] Content projection for "Open With" and "More actions"
diff --git a/docs/release-notes/RelNote210.md b/docs/release-notes/RelNote210.md
index c5cbfdbe93..66f8d49de5 100644
--- a/docs/release-notes/RelNote210.md
+++ b/docs/release-notes/RelNote210.md
@@ -71,7 +71,7 @@ Below are the most important new features of this release:
 -   Start form process pre-filling value
 -   Task List - Support custom HTML template and static columns
 -   Sidebar action menu
--   Infinite pagination component enhancement
+-   [Infinite pagination component](../core/infinite-pagination.component.md) enhancement
 -   App drop-down dialog selector
 -   JS-API Governance
 -   Documentation enhancements
@@ -137,7 +137,7 @@ You then need to pass the node via the input values object along with the other
         'field_one': 'example text'
     };
 
-Note that in the object above, the key file is the name of the attach file field in the start form of the process. The value of the file property must be a [`MinimalNodeEntryEntity`](../content-services/document-library.model.md):
+Note that in the object above, the key file is the name of the attach file field in the start form of the process. The value of the file property must be a `MinimalNodeEntryEntity`:
 
     <adf-start-process
         [values]="formValues"
@@ -290,7 +290,7 @@ For more information about this functionality see the following links:
 
 ### 12. Documentation
 
-The Properties tables in the [documentation](https://alfresco.github.io/adf-component-catalog/) are now updated with the type and the default value of any property.
+The Properties tables in the documentation are now updated with the type and the default value of any property.
 
 ## CI changes
 
@@ -315,7 +315,7 @@ Below you can find a brief list of references to help you start to use the new r
 
 [Getting started guides with Alfresco Application Development Framework](https://community.alfresco.com/community/application-development-framework/pages/get-started)
 
-[Component catalog](https://alfresco.github.io/adf-component-catalog/)
+Component catalog
 
 [Gitter chat supporting Alfresco ADF](https://gitter.im/Alfresco/alfresco-ng2-components)
 
@@ -365,7 +365,7 @@ Release Notes - Apps Development Framework - Version 2.1.
 
 -   \[[ADF-1752](https://issues.alfresco.com/jira/browse/ADF-1752)] - allowInfoDrawer property does not disable the feature when showInfoDrawer is set to true
 -   \[[ADF-1882](https://issues.alfresco.com/jira/browse/ADF-1882)] - Preview uploaded content in APS fails in form
--   \[[ADF-1888](https://issues.alfresco.com/jira/browse/ADF-1888)] - ExternalContent is not exported in ActivitiFormModule
+-   \[[ADF-1888](https://issues.alfresco.com/jira/browse/ADF-1888)] - [ExternalContent](../../lib/core/form/components/widgets/core/external-content.ts) is not exported in ActivitiFormModule
 -   \[[ADF-1889](https://issues.alfresco.com/jira/browse/ADF-1889)] - Viewer does not render PDF renditions unless urlFile ends with .pdf
 -   \[[ADF-1926](https://issues.alfresco.com/jira/browse/ADF-1926)] - [`Form`](../../lib/process-services/task-list/models/form.model.ts) is not exported from ActivitiTaskListModule
 -   \[[ADF-1959](https://issues.alfresco.com/jira/browse/ADF-1959)] - Apps with description appear with larger size on the Processes Services page
@@ -407,7 +407,7 @@ Release Notes - Apps Development Framework - Version 2.1.
 -   \[[ADF-2209](https://issues.alfresco.com/jira/browse/ADF-2209)] - The 'Complete' button of a task that has a form is not properly field with colour when hover
 -   \[[ADF-2210](https://issues.alfresco.com/jira/browse/ADF-2210)] - Dynamic Table title is not aligned properly
 -   \[[ADF-2213](https://issues.alfresco.com/jira/browse/ADF-2213)] - Amount Widget is not aligned
--   \[[ADF-2221](https://issues.alfresco.com/jira/browse/ADF-2221)] - Search fails on Content Node Selector
+-   \[[ADF-2221](https://issues.alfresco.com/jira/browse/ADF-2221)] - Search fails on Content [Node](https://github.com/Alfresco/alfresco-js-api/blob/development/src/api/content-rest-api/docs/Node.md) Selector
 -   \[[ADF-2222](https://issues.alfresco.com/jira/browse/ADF-2222)] - The user profile window is not visible when only Content Services is enabled
 
 ### New Feature
diff --git a/docs/release-notes/RelNote220.md b/docs/release-notes/RelNote220.md
index 3c78ad5b94..024015462d 100644
--- a/docs/release-notes/RelNote220.md
+++ b/docs/release-notes/RelNote220.md
@@ -281,7 +281,7 @@ Below you can find a brief list of references to help you start to use the new r
 
 [Getting started guides with Alfresco Application Development Framework](https://community.alfresco.com/community/application-development-framework/pages/get-started)
 
-[Component catalog](https://alfresco.github.io/adf-component-catalog/)
+Component catalog
 
 [Gitter chat supporting Alfresco ADF](https://gitter.im/Alfresco/alfresco-ng2-components)
 
@@ -384,7 +384,7 @@ Release Notes - Apps Development Framework - Version 2.2.
 -   \[[ADF-2163](https://issues.alfresco.com/jira/browse/ADF-2163)] - content-action target folder and file option
 -   \[[ADF-2298](https://issues.alfresco.com/jira/browse/ADF-2298)] - Process Header - Make it customizable from config file
 -   \[[ADF-2300](https://issues.alfresco.com/jira/browse/ADF-2300)] - [Upload Widget] Actions menu is needed
--   \[[ADF-2304](https://issues.alfresco.com/jira/browse/ADF-2304)] - Add option to Content Node Selector to transform the breadcrumb folder node
+-   \[[ADF-2304](https://issues.alfresco.com/jira/browse/ADF-2304)] - Add option to Content [Node](https://github.com/Alfresco/alfresco-js-api/blob/development/src/api/content-rest-api/docs/Node.md) Selector to transform the breadcrumb folder node
 -   \[[ADF-2322](https://issues.alfresco.com/jira/browse/ADF-2322)] - [Document List] Gallery view
 -   \[[ADF-2340](https://issues.alfresco.com/jira/browse/ADF-2340)] - [Delete directive] delete permanent form trashcan
 -   \[[ADF-2352](https://issues.alfresco.com/jira/browse/ADF-2352)] - It should be possible to project toolbar buttons for the Viewer
diff --git a/docs/release-notes/RelNote230.md b/docs/release-notes/RelNote230.md
index 401ceb672c..bb6a3b7d2a 100644
--- a/docs/release-notes/RelNote230.md
+++ b/docs/release-notes/RelNote230.md
@@ -63,7 +63,7 @@ Below are the most important new features of this release:
 -   Inherit permission button
 -   Share File
 -   Lock File
--   Comment a Node
+-   Comment a [Node](https://github.com/Alfresco/alfresco-js-api/blob/development/src/api/content-rest-api/docs/Node.md)
 -   Inherit Permission Button
 -   [Permission List Component](../content-services/permission-list.component.md)
 -   [Sidenav Layout Component](../core/sidenav-layout.component.md)
@@ -232,7 +232,7 @@ Below you can find a brief list of references to help youstart to use the new re
 
 [Getting started guides with Alfresco Application Development Framework](https://community.alfresco.com/community/application-development-framework/pages/get-started)
 
-[Component catalog](https://alfresco.github.io/adf-component-catalog/)
+Component catalog
 
 [Gitter chat supporting Alfresco ADF](https://gitter.im/Alfresco/alfresco-ng2-components)
 
@@ -316,7 +316,7 @@ Release Notes - Apps Development Framework - Version 2.3.0
 -   \[[ADF-2368](https://issues.alfresco.com/jira/browse/ADF-2368)] - Manage file version is updating wrong files.
 -   \[[ADF-2373](https://issues.alfresco.com/jira/browse/ADF-2373)] - User should be able to see just the sites in which is member in SiteList drop-down
 -   \[[ADF-2393](https://issues.alfresco.com/jira/browse/ADF-2393)] - Error when deleting a folder when Infinite scrolling is enabled and all items are loaded
--   \[[ADF-2397](https://issues.alfresco.com/jira/browse/ADF-2397)] - Sometimes Load more on Content Node Selector does not load next page of results
+-   \[[ADF-2397](https://issues.alfresco.com/jira/browse/ADF-2397)] - Sometimes Load more on Content [Node](https://github.com/Alfresco/alfresco-js-api/blob/development/src/api/content-rest-api/docs/Node.md) Selector does not load next page of results
 -   \[[ADF-2414](https://issues.alfresco.com/jira/browse/ADF-2414)] - Translation missing for warning message on Login Page
 -   \[[ADF-2421](https://issues.alfresco.com/jira/browse/ADF-2421)] - CLONE - Unable to copy / move a file from Recent or Favorites when user has only granular permissions on the file
 -   \[[ADF-2428](https://issues.alfresco.com/jira/browse/ADF-2428)] - \[Demo shell Unable to view document metadata from document list view
@@ -329,7 +329,7 @@ Release Notes - Apps Development Framework - Version 2.3.0
 -   \[[ADF-2454](https://issues.alfresco.com/jira/browse/ADF-2454)] - Login dialog icon and header text not centered correctly
 -   \[[ADF-2455](https://issues.alfresco.com/jira/browse/ADF-2455)] - Document List does not render thumbnails
 -   \[[ADF-2461](https://issues.alfresco.com/jira/browse/ADF-2461)] - Pdf viewer worker are not unregistered
--   \[[ADF-2465](https://issues.alfresco.com/jira/browse/ADF-2465)] - Sometimes, navigating using the breadcrumb opens another folder instead of the clicked one - after search performed on the Content Node Selector
+-   \[[ADF-2465](https://issues.alfresco.com/jira/browse/ADF-2465)] - Sometimes, navigating using the breadcrumb opens another folder instead of the clicked one - after search performed on the Content [Node](https://github.com/Alfresco/alfresco-js-api/blob/development/src/api/content-rest-api/docs/Node.md) Selector
 -   \[[ADF-2468](https://issues.alfresco.com/jira/browse/ADF-2468)] - Error message displayed in console when navigating to tag page
 -   \[[ADF-2470](https://issues.alfresco.com/jira/browse/ADF-2470)] - Search API implementation is incomplete
 -   \[[ADF-2480](https://issues.alfresco.com/jira/browse/ADF-2480)] - Document List is not refreshed after deleting a file
@@ -349,10 +349,10 @@ Release Notes - Apps Development Framework - Version 2.3.0
 -   \[[ADF-2604](https://issues.alfresco.com/jira/browse/ADF-2604)] - Incorrect definitions for Enums
 -   \[[ADF-2607](https://issues.alfresco.com/jira/browse/ADF-2607)] - Task [`Form`](../../lib/process-services/task-list/models/form.model.ts) - Number Widget placeholder no longer displayed
 -   \[[ADF-2624](https://issues.alfresco.com/jira/browse/ADF-2624)] - All metadata card component children display parent info drawer tooltip
--   \[[ADF-2625](https://issues.alfresco.com/jira/browse/ADF-2625)] - Node name not updated when changing its value in metadata component
+-   \[[ADF-2625](https://issues.alfresco.com/jira/browse/ADF-2625)] - [Node](https://github.com/Alfresco/alfresco-js-api/blob/development/src/api/content-rest-api/docs/Node.md) name not updated when changing its value in metadata component
 -   \[[ADF-2628](https://issues.alfresco.com/jira/browse/ADF-2628)] - Metadata editors miss tooltips
 -   \[[ADF-2630](https://issues.alfresco.com/jira/browse/ADF-2630)] - demo shell: tabs of the info drawer are not translated
--   \[[ADF-2634](https://issues.alfresco.com/jira/browse/ADF-2634)] - Node Version List actions are not localised
+-   \[[ADF-2634](https://issues.alfresco.com/jira/browse/ADF-2634)] - [Node](https://github.com/Alfresco/alfresco-js-api/blob/development/src/api/content-rest-api/docs/Node.md) Version List actions are not localised
 -   \[[ADF-2636](https://issues.alfresco.com/jira/browse/ADF-2636)] - Console gives an error when trying to load ADF on safari
 -   \[[ADF-2660](https://issues.alfresco.com/jira/browse/ADF-2660)] - ADF [Process Service](../process-services/process.service.md) lib is not importing the content dependency
 -   \[[ADF-2662](https://issues.alfresco.com/jira/browse/ADF-2662)] - [Settings Component] Still able to sign in when changing APS or ACS URLS to invalid URL
@@ -397,7 +397,7 @@ Release Notes - Apps Development Framework - Version 2.3.0
 -   \[[ADF-2394](https://issues.alfresco.com/jira/browse/ADF-2394)] - Process List Component - Should expose the mutiSelect property
 -   \[[ADF-2405](https://issues.alfresco.com/jira/browse/ADF-2405)] - [Process Service](../process-services/process.service.md) - Add a new method to get all process definition versions
 -   \[[ADF-2412](https://issues.alfresco.com/jira/browse/ADF-2412)] - Task List - refactoring
--   \[[ADF-2417](https://issues.alfresco.com/jira/browse/ADF-2417)] - Remove the default Node ID from tag page in demo-shell
+-   \[[ADF-2417](https://issues.alfresco.com/jira/browse/ADF-2417)] - Remove the default [Node](https://github.com/Alfresco/alfresco-js-api/blob/development/src/api/content-rest-api/docs/Node.md) ID from tag page in demo-shell
 -   \[[ADF-2424](https://issues.alfresco.com/jira/browse/ADF-2424)] - Docker file size decreasing
 -   \[[ADF-2462](https://issues.alfresco.com/jira/browse/ADF-2462)] - Automatic PR script after any beta release
 -   \[[ADF-2471](https://issues.alfresco.com/jira/browse/ADF-2471)] - Create smoke tests to cover Colour change component
diff --git a/docs/release-notes/RelNote240.md b/docs/release-notes/RelNote240.md
index 3794d9004b..9f026049d6 100644
--- a/docs/release-notes/RelNote240.md
+++ b/docs/release-notes/RelNote240.md
@@ -72,7 +72,7 @@ Below are the most important new features of this release:
 
 With ADF 2.4.0 we support SSO as login for CS and PS both of which include native support for using Keycloak.
 For more information about how to configure SSO on ADF please refer to:
-[the SSO section of the Login component docs.](https://github.com/Alfresco/alfresco-ng2-components/blob/development/docs/core/login.component.md#sso-login)
+[the SSO section of the Login component docs.](https://github.com/Alfresco/alfresco-ng2-components/blob/development/docs/core/login.component.md#single-sign-on-sso)
 
 **Please note that the SSO support requires ACS 6.0, APS 1.9 or later using Keycloak.**
 
@@ -123,7 +123,7 @@ You can still override it from the parent component using `<ng-template>`.
 
 ### ProcessList Empty Page
 
-In the version 2.4, the [`ProcessList`](../../lib/process-services/mock/process/process.model.mock.ts) uses the empty state component if there are no available processes.   
+In the version 2.4, the [`ProcessList`](../../lib/process-services/mock/process/process.model.mock.ts) uses the empty state component if there are no available processes.  
 You can still override it from the parent component using `<ng-template>`.
 
 ![Process list Empty Page](images/Screen+Shot+2018-06-25+at+11.16.57.png)
@@ -215,7 +215,7 @@ Below you can find a brief list of references to help you start using the new re
 
 -   [Official GitHub Project - alfresco-ng2-components](https://github.com/Alfresco/alfresco-ng2-components)
 -   [Getting started guides with Alfresco Application Development Framework](https://community.alfresco.com/community/application-development-framework/pages/get-started)
--   [Component catalog](https://alfresco.github.io/adf-component-catalog/)
+-   Component catalog
 -   [Gitter chat supporting Alfresco ADF](https://gitter.im/Alfresco/alfresco-ng2-components)
 -   [ADF examples](https://github.com/Alfresco/adf-examples)
 -   [List of all components](https://github.com/Alfresco/alfresco-ng2-components/tree/master/ng2-components)
@@ -314,7 +314,7 @@ Release Notes - Apps Development Framework - Version 2.4.0
 -   \[[ADF-2726](https://issues.alfresco.com/jira/browse/ADF-2726)] - Not able to view a file from the attach file widget.
 -   \[[ADF-2739](https://issues.alfresco.com/jira/browse/ADF-2739)] - Breadcrumb issue if the folder name is too big.
 -   \[[ADF-2760](https://issues.alfresco.com/jira/browse/ADF-2760)] - Background colour for document lists is not white
--   \[[ADF-2766](https://issues.alfresco.com/jira/browse/ADF-2766)] - Download Node Directive does not work with Shared Links
+-   \[[ADF-2766](https://issues.alfresco.com/jira/browse/ADF-2766)] - Download [Node](https://github.com/Alfresco/alfresco-js-api/blob/development/src/api/content-rest-api/docs/Node.md) Directive does not work with Shared Links
 -   \[[ADF-2767](https://issues.alfresco.com/jira/browse/ADF-2767)] - Side nav is not responsive
 -   \[[ADF-2771](https://issues.alfresco.com/jira/browse/ADF-2771)] - [Sidebar action menu component](../core/sidebar-action-menu.component.md) - UX review
 -   \[[ADF-2772](https://issues.alfresco.com/jira/browse/ADF-2772)] - Sidenav Layout - UX review
diff --git a/docs/release-notes/RelNote250.md b/docs/release-notes/RelNote250.md
index 21491d16ef..1119b19c76 100644
--- a/docs/release-notes/RelNote250.md
+++ b/docs/release-notes/RelNote250.md
@@ -139,7 +139,7 @@ For more information about this component please refer to the
 
 ### NotificationService customizability improvement
 
-The NotificationService now exposes a new input parameter to allow a full customization of the notification message: 
+The [NotificationService](../core/notification.service.md) now exposes a new input parameter to allow a full customization of the notification message: 
 
 -   Direction : Text layout direction for the snack bar.
 -   Duration : The length of time in milliseconds to wait before automatically dismissing the snack bar.
@@ -194,7 +194,7 @@ Below you can find a brief list of references to help you start using the new re
 
 [Getting started guides with Alfresco Application Development Framework](https://community.alfresco.com/community/application-development-framework/pages/get-started)
 
-[Component catalog](https://alfresco.github.io/adf-component-catalog/)
+Component catalog
 
 [Gitter chat supporting Alfresco ADF](https://gitter.im/Alfresco/alfresco-ng2-components)
 
diff --git a/docs/release-notes/RelNote260.md b/docs/release-notes/RelNote260.md
index 3cd2ea565d..137515abd9 100644
--- a/docs/release-notes/RelNote260.md
+++ b/docs/release-notes/RelNote260.md
@@ -51,14 +51,14 @@ Below are the most important new features of this release:
 -   **Show sidebar on the right option**
 -   **Double sidebar for viewer**
 -   **Smart folder icon**
--   **Tag node list component has a configurable delete button for tag**
--   **Validation summary for form component**
+-   **[Tag node list component](../content-services/tag-node-list.component.md) has a configurable delete button for tag**
+-   **Validation summary for [form component](../core/form.component.md)**
 -   **Share link with expiry date**
 -   **Base extensibility support**
 
 ### Show more/less tag
 
-The **Tag List Component** has two new buttons that allow the user to see more/less tags. This turns out to be more useful than showing the whole list of tags related to a node. This functionality is already embedded into the component and the user doesn't have to do anything to make it work.
+The **[Tag List Component](../content-services/tag-list.component.md)** has two new buttons that allow the user to see more/less tags. This turns out to be more useful than showing the whole list of tags related to a node. This functionality is already embedded into the component and the user doesn't have to do anything to make it work.
 
     <adf-tag-list></adf-tag-list>
 
@@ -74,7 +74,7 @@ The **Sidenav Component** now accepts the **position** as an input parameter so
 
 ### Double sidebar for viewer
 
-An extra sidebar is now available to use within the **Viewer Component**. This helps the user to organise the information related to the node in a better way.
+An extra sidebar is now available to use within the **[Viewer Component](../core/viewer.component.md)**. This helps the user to organise the information related to the node in a better way.
 
      <ng-template #sidebarRightTemplate>
        //your right sidebar content here
@@ -99,7 +99,7 @@ The **DocumentList Component** can now show different icons for **Smart Folders*
 
 ### Tag node list component has a configurable delete button for tag
 
-A configurable delete button has been added to the **Tag Node List Component** to let you show it only when user has permissions.
+A configurable delete button has been added to the **Tag [Node](https://github.com/Alfresco/alfresco-js-api/blob/development/src/api/content-rest-api/docs/Node.md) List Component** to let you show it only when user has permissions.
 
     <adf-tag-node-list [showDelete]="showDelete" [nodeId]="nodeId"></adf-tag-node-list>
 
@@ -107,7 +107,7 @@ A configurable delete button has been added to the **Tag Node List Component** t
 
 ### Validation summary support for form component
 
-The **Form Component** will now use the **formError** event to send a validation summary for all the fields with errors. This will be useful particularly with big forms for showing which fields are in error without scrolling the whole form by creating a summary.
+The **[Form](../../lib/process-services/task-list/models/form.model.ts) Component** will now use the **formError** event to send a validation summary for all the fields with errors. This will be useful particularly with big forms for showing which fields are in error without scrolling the whole form by creating a summary.
 
     <div class="form-container">
     <adf-form
@@ -125,7 +125,7 @@ The **Form Component** will now use the **formError** event to send a validation
 
 ### Share link with expiry date
 
-Some extra information is now available for shared links: expiry date. The earliest date accepted is at least 24h after the time you created it (following the ACS specification : [here](https://docs.alfresco.com/5.2/concepts/repository-properties.html) is the link). This is embedded into the **Share Dialog Component** and will be automatically shown when the share dialog is displayed.
+Some extra information is now available for shared links: expiry date. The earliest date accepted is at least 24h after the time you created it (following the ACS specification : [here](https://docs.alfresco.com/5.2/concepts/repository-properties.html) is the link). This is embedded into the **[Share Dialog Component](../../lib/content-services/content-node-share/content-node-share.dialog.ts)** and will be automatically shown when the share dialog is displayed.
 
 ![Expiry Share Link](images/ShareExpiryLink.gif)
 
@@ -147,7 +147,7 @@ Below you can find a brief list of references to help you start using the new re
 
 [Getting started guides with Alfresco Application Development Framework](https://community.alfresco.com/community/application-development-framework/pages/get-started)
 
-[Component catalog](https://alfresco.github.io/adf-component-catalog/)
+Component catalog
 
 [Gitter chat supporting Alfresco ADF](https://gitter.im/Alfresco/alfresco-ng2-components)
 
@@ -176,11 +176,11 @@ Release Notes - Apps Development Framework - Version 2.6.
 
 ### Feature
 
--   \[[ADF-584](https://issues.alfresco.com/jira/browse/ADF-584)] - Validation summary support for Form component
+-   \[[ADF-584](https://issues.alfresco.com/jira/browse/ADF-584)] - Validation summary support for [Form](../../lib/process-services/task-list/models/form.model.ts) component
 -   \[[ADF-2640](https://issues.alfresco.com/jira/browse/ADF-2640)] - adf-tag-node-list with remove option configurable
 -   \[[ADF-2921](https://issues.alfresco.com/jira/browse/ADF-2921)] - Icons for smart folders, links and folders with rules
--   \[[ADF-3308](https://issues.alfresco.com/jira/browse/ADF-3308)] - ProcessList Component - Provide a way to filter the list by fields
--   \[[ADF-3352](https://issues.alfresco.com/jira/browse/ADF-3352)] - Viewer Component - Allow multiple side bar
+-   \[[ADF-3308](https://issues.alfresco.com/jira/browse/ADF-3308)] - [ProcessList](../../lib/process-services/mock/process/process.model.mock.ts) Component - Provide a way to filter the list by fields
+-   \[[ADF-3352](https://issues.alfresco.com/jira/browse/ADF-3352)] - [Viewer Component](../core/viewer.component.md) - Allow multiple side bar
 -   \[[ADF-3382](https://issues.alfresco.com/jira/browse/ADF-3382)] - Start a Process - Change the process definition from a dropdown to autocomplete
 -   \[[ADF-3397](https://issues.alfresco.com/jira/browse/ADF-3397)] - Task Filter - Doesn't show the right icon
 -   \[[ADF-3415](https://issues.alfresco.com/jira/browse/ADF-3415)] - Process Filter - Doesn't show the right icon
@@ -188,11 +188,11 @@ Release Notes - Apps Development Framework - Version 2.6.
 -   \[[ADF-3438](https://issues.alfresco.com/jira/browse/ADF-3438)] - Task List Demo Page - Add page/size parameters
 -   \[[ADF-3443](https://issues.alfresco.com/jira/browse/ADF-3443)] - Move print from ACA to ADF
 -   \[[ADF-3499](https://issues.alfresco.com/jira/browse/ADF-3499)] - ACS APS Integration - Not able to upload a file in case the user has more than one alfresco repositories
--   \[[ADF-3507](https://issues.alfresco.com/jira/browse/ADF-3507)] - Show more/fewer tags buttons in Tag List Component
--   \[[ADF-3512](https://issues.alfresco.com/jira/browse/ADF-3512)] - SidenavLayoutComponent option to show the sidebar on the right
+-   \[[ADF-3507](https://issues.alfresco.com/jira/browse/ADF-3507)] - Show more/fewer tags buttons in [Tag List Component](../content-services/tag-list.component.md)
+-   \[[ADF-3512](https://issues.alfresco.com/jira/browse/ADF-3512)] - [SidenavLayoutComponent](../core/sidenav-layout.component.md) option to show the sidebar on the right
 -   \[[ADF-3553](https://issues.alfresco.com/jira/browse/ADF-3553)] - Cache management for application configuration file
 -   \[[ADF-3570](https://issues.alfresco.com/jira/browse/ADF-3570)] - Migration to APS2 - Add a interceptor to be able to use APS2 API
--   \[[ADF-3607](https://issues.alfresco.com/jira/browse/ADF-3607)] - [Demo shell] JSON Editor in Form Page
+-   \[[ADF-3607](https://issues.alfresco.com/jira/browse/ADF-3607)] - [Demo shell] JSON Editor in [Form](../../lib/process-services/task-list/models/form.model.ts) Page
 
 ### Bug
 
@@ -247,7 +247,7 @@ Release Notes - Apps Development Framework - Version 2.6.
 
 ### Task
 
--   \[[ADF-3335](https://issues.alfresco.com/jira/browse/ADF-3335)] - Create automated tests for Task filters component
+-   \[[ADF-3335](https://issues.alfresco.com/jira/browse/ADF-3335)] - Create automated tests for [Task filters component](../process-services/task-filters.component.md)
 -   \[[ADF-3393](https://issues.alfresco.com/jira/browse/ADF-3393)] - Add delete AWS environment in the creator/destructor script
 -   \[[ADF-3480](https://issues.alfresco.com/jira/browse/ADF-3480)] - Fix failing automated tests
 -   \[[ADF-3504](https://issues.alfresco.com/jira/browse/ADF-3504)] - Add needed images to stack adf-acs6. 
@@ -262,7 +262,7 @@ Release Notes - Apps Development Framework - Version 2.6.
 
 ### Feature Bug
 
--   \[[ADF-3413](https://issues.alfresco.com/jira/browse/ADF-3413)] - Form name still displayed after removing form
+-   \[[ADF-3413](https://issues.alfresco.com/jira/browse/ADF-3413)] - [Form](../../lib/process-services/task-list/models/form.model.ts) name still displayed after removing form
 -   \[[ADF-3567](https://issues.alfresco.com/jira/browse/ADF-3567)] - The default items per page value is not displayed
 -   \[[ADF-3571](https://issues.alfresco.com/jira/browse/ADF-3571)] - Due After field not working as expected
 -   \[[ADF-3573](https://issues.alfresco.com/jira/browse/ADF-3573)] - Showing NaN-20 of 20 is displayed instead of 20
@@ -274,8 +274,8 @@ Release Notes - Apps Development Framework - Version 2.6.
 -   \[[ADF-3376](https://issues.alfresco.com/jira/browse/ADF-3376)] - Create automated tests for comments - Process services - Process
 -   \[[ADF-3377](https://issues.alfresco.com/jira/browse/ADF-3377)] - Create automated tests for comments - Process services - Tasks
 -   \[[ADF-3378](https://issues.alfresco.com/jira/browse/ADF-3378)] - Create automated tests for comments - Content Services PT2
--   \[[ADF-3414](https://issues.alfresco.com/jira/browse/ADF-3414)] - Create automated test for Attach form component
--   \[[ADF-3481](https://issues.alfresco.com/jira/browse/ADF-3481)] - Updated automated tests for attach form component
+-   \[[ADF-3414](https://issues.alfresco.com/jira/browse/ADF-3414)] - Create automated test for [Attach form component](../process-services/attach-form.component.md)
+-   \[[ADF-3481](https://issues.alfresco.com/jira/browse/ADF-3481)] - Updated automated tests for [attach form component](../process-services/attach-form.component.md)
 -   \[[ADF-3519](https://issues.alfresco.com/jira/browse/ADF-3519)] - Fixing tests for Task Filters
 -   \[[ADF-3520](https://issues.alfresco.com/jira/browse/ADF-3520)] - Fixing tests for Document List - Actions
 -   \[[ADF-3521](https://issues.alfresco.com/jira/browse/ADF-3521)] - Fixing tests for Version - Actions
@@ -294,6 +294,6 @@ Release Notes - Apps Development Framework - Version 2.6.
 -   \[[ADF-3563](https://issues.alfresco.com/jira/browse/ADF-3563)] - Automated test for Show More/Less button in Search Filters
 -   \[[ADF-3594](https://issues.alfresco.com/jira/browse/ADF-3594)] - Create automated test for Show more/ less button on Tag component.
 -   \[[ADF-3596](https://issues.alfresco.com/jira/browse/ADF-3596)] - Automated tests for start a process
--   \[[ADF-3597](https://issues.alfresco.com/jira/browse/ADF-3597)] - Create automated test to cover Error Log on Form component
+-   \[[ADF-3597](https://issues.alfresco.com/jira/browse/ADF-3597)] - Create automated test to cover Error Log on [Form](../../lib/process-services/task-list/models/form.model.ts) component
 
 Please refer to [the Alfresco issue tracker](https://issues.alfresco.com/jira/projects/ADF/issues/ADF-581?filter=allopenissues) for other known issues in this release. If you have any questions about the release, please contact us using [gitter](https://gitter.im/Alfresco/alfresco-ng2-components).
diff --git a/docs/tutorials/README.md b/docs/tutorials/README.md
index 65bdf4b4bf..dc1ade1809 100644
--- a/docs/tutorials/README.md
+++ b/docs/tutorials/README.md
@@ -8,14 +8,14 @@ Github only: true
 | Name | Level | Abstract |
 | -- | -- | -- |
 | [**Creating your first ADF application**](creating-your-first-adf-application.md) | Basic | This tutorial shows you how to set up your development environment and create an ADF application. |
-| [**Creating your ADF application using Yeoman**](creating-the-app-using-yeoman.md) | Basic | In this tutorial you are going to see how to create an ADF application from scratch, using the [Yeoman scaffolding tool](http://yeoman.io/). This is a "getting started" task that should enable you to start developing your own ADF application. |
-| [**Creating your Alfresco JavaScript application**](creating-javascript-app-using-alfresco-js-api.md) | Basic | In this tutorial you will learn how to create an application in JavaScript from scratch to interact with Alfresco. This is a "getting started" task that should enable you to start developing your own JavaScript application on top of Alfresco Content Services or Alfresco Process Services. |
-| [**Adding a new component**](new-component.md) | Basic | By definition, a _component_ controls a patch of screen called a _view_. For example, individual components define and control menus, tabs, forms, buttons and every simple or complex portion ofan application's layout. In this tutorial, you will learn how to create a component using [Angular CLI](https://cli.angular.io/) within an existing application. |
-| [**Adding a new view**](new-view.md) | Beginner | Every application developed in Angular is a single page application where the concepts of _view_ and _routing_ play a key role in the user experience. Being a single page application, the navigation between the different layouts (called _views_) is enabled through the _routing_. In this tutorial you will learn how to create a new view in your application and how to access it using a defined endpoint. |
+| [**Creating your ADF application using Yeoman**](creating-the-app-using-yeoman.md) | Basic | In this tutorial you are going to see how to create an ADF application from scratch, using the [Yeoman scaffolding tool](http://yeoman.io/). |
+| [**Creating your Alfresco JavaScript application**](creating-javascript-app-using-alfresco-js-api.md) | Basic | In this tutorial you will learn how to create an application in JavaScript from scratch to interact with Alfresco. |
+| [**Adding a new component**](new-component.md) | Basic | In this tutorial, you will learn how to create a component using [Angular CLI](https://cli.angular.io/) within an existing application. |
+| [**Adding a new view**](new-view.md) | Beginner | In this tutorial you will learn how to create a new view in your application and how to access it using a defined endpoint. |
 | [**Using ADF Components**](using-components.md) | Basic | In this tutorial you will learn how to extend, use and configure ADF Components. |
-| [**Basic theming**](basic-theming.md) | Beginner | As detailed in the [user guide page about theming](../user-guide/theming.md), you can easily customize the [Cascading Style Sheets](https://en.wikipedia.org/wiki/Cascading_Style_Sheets) used by an ADF application. In this tutorial you will see how to modify the CSS, using a step-by-step approach. The focus of this tutorial is [ADF apps built using Yeoman](./creating-the-app-using-yeoman.md), but you can use the same principles to customize the themes in any ADF application. |
-| [**Customizing the Login component**](customising-login.md) | Intermediate | In this tutorial you will learn how to customize the [`Login` component](https://alfresco.github.io/adf-component-catalog/components/LoginComponent.html) following the [technical documentation](https://alfresco.github.io/adf-component-catalog/components/LoginComponent.html). The task will be very simple. See the documentation for further details about customizing this component, along with examples. |
-| [**Working with a Data Table**](working-with-data-table.md) | Intermediate | In this tutorial you will learn how to populate a [`DataTable` component](https://alfresco.github.io/adf-component-catalog/components/DataTableComponent.html) with custom data from a generic back-end service or third party API. As an example we are going to use data from one of the available services on Alfresco Content Services. However, the procedure is much the same if want to use an Alfresco Process Services endpoint or a third party API. |
-| [**Working with the Nodes API Service**](working-with-nodes-api-service.md) |  | In this tutorial you will learn how to use the [`NodesApiService`](../core/nodes-api.service.md). We have developed some practical examples to show you how to interact with an instance of Alfresco Content Services without using the REST endpoints directly. With this approach the [`NodesApiService`](../core/nodes-api.service.md) is used as an abstraction layer, defined by one of the services in the ADF Core library. |
-| [**Working with Nodes using the JS API**](working-with-nodes-js-api.md) |  | In this tutorial you will learn how to use the [`AlfrescoCoreRestApi`](https://github.com/Alfresco/alfresco-js-api/tree/master/src/alfresco-core-rest-api). We have developed some practical examples to show you how to interact with an instance of Alfresco Content Services without using the REST endpoints directly. With this approach the `AlfrescoCoreRestApi` is used as an abstraction layer, defining one of the core services of the [`alfresco-api-js`](https://github.com/Alfresco/alfresco-js-api) library. |
-| [**Content metadata component**](content-metadata-component.md) | Advanced | In this tutorial you will learn how to work with the [`ContentMetadataComponent`](../content-services/content-metadata.component.md). This component is used to render the standard and custom metadata of generic content item (called a _node_) stored in Alfresco Content Services. With the usual approach "learning by doing", you will see here some practical examples you might find useful in your own applicatioin. As a starting point, we will use and customize the [Alfresco Content App](https://github.com/Alfresco/alfresco-content-app). |
+| [**Basic theming**](basic-theming.md) | Beginner | In this tutorial you will see how to theme an ADF app by modifying the CSS.  |
+| [**Customizing the Login component**](customising-login.md) | Intermediate | In this tutorial you will learn how to customize the Login component following the technical documentation. |
+| [**Working with a Data Table**](working-with-data-table.md) | Intermediate | In this tutorial you will learn how to populate a DataTable component. |
+| [**Working with the Nodes API Service**](working-with-nodes-api-service.md) | Intermediate | In this tutorial you will learn how to use the [`NodesApiService`](../core/nodes-api.service.md). |
+| [**Working with Nodes using the JS API**](working-with-nodes-js-api.md) | Intermediate | In this tutorial you will learn how to use the [`AlfrescoCoreRestApi`](https://github.com/Alfresco/alfresco-js-api/tree/master/src/alfresco-core-rest-api). |
+| [**Content metadata component**](content-metadata-component.md) | Advanced | In this tutorial you will learn how to work with the [`ContentMetadataComponent`](../content-services/content-metadata.component.md). |
diff --git a/docs/tutorials/basic-theming.md b/docs/tutorials/basic-theming.md
index 9496fe3086..3d472ac62a 100644
--- a/docs/tutorials/basic-theming.md
+++ b/docs/tutorials/basic-theming.md
@@ -5,7 +5,9 @@ Level: Beginner
 
 # Basic theming
 
-As detailed in the [user guide page about theming](../user-guide/theming.md), you can easily customize the [Cascading Style Sheets](https://en.wikipedia.org/wiki/Cascading_Style_Sheets) used by an ADF application. In this tutorial you will see how to modify the CSS, using a step-by-step approach. The focus of this tutorial is [ADF apps built using Yeoman](./creating-the-app-using-yeoman.md), but you can use the same principles to customize the themes in any ADF application.
+In this tutorial you will see how to theme an ADF app by modifying the CSS. 
+
+As detailed in the [user guide page about theming](../user-guide/theming.md), you can easily customize the [Cascading Style Sheets](https://en.wikipedia.org/wiki/Cascading_Style_Sheets) used by an ADF application. The focus of this tutorial is [ADF apps built using Yeoman](./creating-the-app-using-yeoman.md), but you can use the same principles to customize the themes in any ADF application.
 
 ## About the `adf-core` theming 
 
diff --git a/docs/tutorials/content-metadata-component.md b/docs/tutorials/content-metadata-component.md
index 8a5e4f8df7..b1e55fe6d5 100644
--- a/docs/tutorials/content-metadata-component.md
+++ b/docs/tutorials/content-metadata-component.md
@@ -5,7 +5,9 @@ Level: Advanced
 
 # Content metadata component
 
-In this tutorial you will learn how to work with the [`ContentMetadataComponent`](../content-services/content-metadata.component.md). This component is used to render the standard and custom metadata of generic content item (called a _node_) stored in Alfresco Content Services. With the usual approach "learning by doing", you will see here some practical examples you might find useful in your own applicatioin. As a starting point, we will use and customize the [Alfresco Content App](https://github.com/Alfresco/alfresco-content-app).
+In this tutorial you will learn how to work with the [`ContentMetadataComponent`](../content-services/content-metadata.component.md).
+
+This component is used to render the standard and custom metadata of generic content item (called a _node_) stored in Alfresco Content Services. With the usual approach "learning by doing", you will see here some practical examples you might find useful in your own applicatioin. As a starting point, we will use and customize the [Alfresco Content App](https://github.com/Alfresco/alfresco-content-app).
 
 ## About the `ContentMetadataComponent`
 
diff --git a/docs/tutorials/creating-javascript-app-using-alfresco-js-api.md b/docs/tutorials/creating-javascript-app-using-alfresco-js-api.md
index 3b88e75ccd..836bc3c229 100644
--- a/docs/tutorials/creating-javascript-app-using-alfresco-js-api.md
+++ b/docs/tutorials/creating-javascript-app-using-alfresco-js-api.md
@@ -5,7 +5,9 @@ Level: Basic
 
 # Creating your Alfresco JavaScript application
 
-In this tutorial you will learn how to create an application in JavaScript from scratch to interact with Alfresco. This is a "getting started" task that should enable you to start developing your own JavaScript application on top of Alfresco Content Services or Alfresco Process Services.
+In this tutorial you will learn how to create an application in JavaScript from scratch to interact with Alfresco.
+
+This is a "getting started" task that should enable you to start developing your own JavaScript application on top of Alfresco Content Services or Alfresco Process Services.
 
 The tutorial uses Alfresco Content Services for demonstration purposes, but development on
 top of Alfresco Process Services follows exactly the same principles.
@@ -24,7 +26,7 @@ If you don't have an instance of Alfresco Content Services up and running, see
 [Preparing the development environment](./preparing-environment.md)
 to learn how to set it up.
 
-You will need the `npm` client to download the requested Node libraries (also explained in
+You will need the `npm` client to download the requested [`Node`](https://github.com/Alfresco/alfresco-js-api/blob/development/src/api/content-rest-api/docs/Node.md) libraries (also explained in
 [Preparing the development environment](./preparing-environment.md)).
 
 ## Creating the JavaScript application
@@ -95,7 +97,7 @@ To deploy the  `my-js-app` application into the Alfresco Content Services Docker
     // List the active containers into your environment.
     docker container ls
 
-	// Copy the CONTAINER_ID of the image with name 'alfresco/alfresco-content-repository-community:...'.
+    // Copy the CONTAINER_ID of the image with name 'alfresco/alfresco-content-repository-community:...'.
 
     // Open a shell into the container.
     docker exec -i -t <CONTAINER_ID> /bin/bash
@@ -103,10 +105,10 @@ To deploy the  `my-js-app` application into the Alfresco Content Services Docker
     // Create the 'my-js-app' folder into the Tomcat's webapps folder.
     mkdir webapps/my-js-app
 
-	// Back to the host's shell.
+    // Back to the host's shell.
     exit
 
-	// Copy the 'my-js-app' folder into the Tomcat's webapps folder.
+    // Copy the 'my-js-app' folder into the Tomcat's webapps folder.
     docker cp ../my-js-app <CONTAINER_ID>:/usr/local/tomcat/webapps
 
 This is all you need to deploy the JavaScript application into the same Tomcat instance as
diff --git a/docs/tutorials/creating-the-app-using-yeoman.md b/docs/tutorials/creating-the-app-using-yeoman.md
index 77e3bf2f69..aa42e34371 100644
--- a/docs/tutorials/creating-the-app-using-yeoman.md
+++ b/docs/tutorials/creating-the-app-using-yeoman.md
@@ -5,7 +5,9 @@ Level: Basic
 
 # Creating your ADF application using Yeoman
 
-In this tutorial you are going to see how to create an ADF application from scratch, using the [Yeoman scaffolding tool](http://yeoman.io/). This is a "getting started" task that should enable you to start developing your own ADF application.
+In this tutorial you are going to see how to create an ADF application from scratch, using the [Yeoman scaffolding tool](http://yeoman.io/).
+
+This is a "getting started" task that should enable you to start developing your own ADF application.
 
 ## Prerequisites
 
diff --git a/docs/tutorials/customising-login.md b/docs/tutorials/customising-login.md
index d64790c694..d98e0c667c 100644
--- a/docs/tutorials/customising-login.md
+++ b/docs/tutorials/customising-login.md
@@ -5,7 +5,9 @@ Level: Intermediate
 
 # Customizing the Login component
 
-In this tutorial you will learn how to customize the [`Login` component](https://alfresco.github.io/adf-component-catalog/components/LoginComponent.html) following the [technical documentation](https://alfresco.github.io/adf-component-catalog/components/LoginComponent.html). The task will be very simple. See the documentation for further details about customizing this component, along with examples.
+In this tutorial you will learn how to customize the [Login component](../core/login.component.md) following the technical documentation.
+
+The task will be very simple. See the documentation for further details about customizing this component, along with examples.
 
 ## Locating the component into your application
 
@@ -14,15 +16,15 @@ Starting from an existing ADF application, the `Login` component, like any other
 it is stored in the `/src/app/components/login` path. In an ADF app created with [Yeoman](http://yeoman.io/)
 it is stored in the `/src/app/login` path.
 
-Once you have located the `Login` component for your application, you can customize it as described below. 
+Once you have located the Login component for your application, you can customize it as described below. 
 
 ## Changing the header
 
 As with every regular
 [Angular Component](https://angular.io/guide/architecture-components),
-you can customize the `Login` component can be customised via CSS, HTML and Typescript. In this simple
+you can customize the Login component can be customised via CSS, HTML and Typescript. In this simple
 example, we will customize the header (as described also in the
-[technical documentation](https://alfresco.github.io/adf-component-catalog/components/LoginComponent.html)).
+[technical documentation](../core/login.component.md)).
 
 Open the [`login.component`](../core/login.component.md)`.html` file and change the content to match the following source code:
 
@@ -38,7 +40,7 @@ After saving the file, the login form will look like this:
 
 ## More examples
 
-As mentioned earlier, this is a very basic example and the `Login` component can be customized
+As mentioned earlier, this is a very basic example and the Login component can be customized
 much more extensively than this. For a complete and detailed description, full of examples, check the
-[technical documentation about the component](https://alfresco.github.io/adf-component-catalog/components/LoginComponent.html).
-This describes every customization available for the `Login` component.
+[technical documentation about the component](../core/login.component.md).
+This describes every customization available for the Login component.
diff --git a/docs/tutorials/new-component.md b/docs/tutorials/new-component.md
index a8c8a3ea6e..ff54d8f607 100644
--- a/docs/tutorials/new-component.md
+++ b/docs/tutorials/new-component.md
@@ -5,7 +5,9 @@ Level: Basic
 
 # Adding a new component
 
-By definition, a _component_ controls a patch of screen called a _view_. For example, individual components define and control menus, tabs, forms, buttons and every simple or complex portion ofan application's layout. In this tutorial, you will learn how to create a component using [Angular CLI](https://cli.angular.io/) within an existing application.
+In this tutorial, you will learn how to create a component using [Angular CLI](https://cli.angular.io/) within an existing application.
+
+By definition, a _component_ controls a patch of screen called a _view_. For example, individual components define and control menus, tabs, forms, buttons and every simple or complex portion of an application's layout. 
 
 ## Creating a component
 
diff --git a/docs/tutorials/new-view.md b/docs/tutorials/new-view.md
index 29af04e6a2..7b5491ec02 100644
--- a/docs/tutorials/new-view.md
+++ b/docs/tutorials/new-view.md
@@ -5,7 +5,9 @@ Level: Beginner
 
 # Adding a new view
 
-Every application developed in Angular is a single page application where the concepts of *view* and *routing* play a key role in the user experience. Being a single page application, the navigation between the different layouts (called *views*) is enabled through the *routing*. In this tutorial you will learn how to create a new view in your application and how to access it using a defined endpoint.
+In this tutorial you will learn how to create a new view in your application and how to access it using a defined endpoint.
+
+Every application developed in Angular is a single page application where the concepts of *view* and *routing* play a key role in the user experience. Being a single page application, the navigation between the different layouts (called *views*) is enabled through the *routing*. 
 
 ## Creating a view
 
diff --git a/docs/tutorials/preparing-environment.md b/docs/tutorials/preparing-environment.md
index 512a86f098..138950dd35 100644
--- a/docs/tutorials/preparing-environment.md
+++ b/docs/tutorials/preparing-environment.md
@@ -5,16 +5,18 @@ Level: Beginner
 
 # Preparing the development environment
 
-Here you will find the prerequisites for all the tutorials and descriptions of the entire documentation. This document contains the development environment description, along with the details of the suggested versions for each tool, library and module.
+Here you will find the prerequisites for all the tutorials and descriptions of the entire documentation.
+
+This document contains the development environment description, along with the details of the suggested versions for each tool, library and module.
 
 ## Node.js
 
-[Node.js](https://nodejs.org) is a JavaScript runtime built using an event-driven, non-blocking I/O model that makes it lightweight and efficient. Node.js uses [npm](https://www.npmjs.com/) as a public registry and package system.
+[Node.js](https://nodejs.org) is a JavaScript runtime built using an event-driven, non-blocking I/O model that makes it lightweight and efficient. [`Node`](https://github.com/Alfresco/alfresco-js-api/blob/development/src/api/content-rest-api/docs/Node.md).js uses [npm](https://www.npmjs.com/) as a public registry and package system.
 
 You need the latest `node.js` from either the `8.x` or `9.x` branch.
 To check the version, run the following command in a terminal. 
 
-	node -v
+    node -v
 
 ## Angular CLI
 
@@ -24,15 +26,15 @@ Version 1.6.6 seems to be the most stable version currently. Earlier and later v
 
 If you already have `Angular CLI` installed check the version by running:
 
-	ng --version
+    ng --version
 
 To globally install `Angular CLI` version globally 1.6.6 run:
 
-	sudo npm install -g @angular/cli@1.6.6
+    sudo npm install -g @angular/cli@1.6.6
 
 ## Code Editor
 
-We recommend [Visual Studio Code](http://code.visualstudio.com) - it's a free, lightweight and *very* powerful tool from Microsoft that works well for Angular development.
+We recommend [Visual Studio Code](http://code.visualstudio.com) - it's a free, lightweight and _very_ powerful tool from Microsoft that works well for Angular development.
 
 ## Alfresco Content Services (optional)
 
@@ -52,24 +54,24 @@ Please note that ADF applications are compatible with [Alfresco Process Services
 
 You can check if you have `Yeoman` installed by running `yo --version`. If this is not in your system then you can install it by running:
 
-	sudo npm install -g yo
+    sudo npm install -g yo
 
 (The `sudo` command is not required on Windows but you may need to ensure you are running a command
 prompt with Administrator privileges).
 
 Install the latest version of the `generator-alfresco-adf-app` using the following command.
 
-	sudo npm install -g generator-alfresco-adf-app
+    sudo npm install -g generator-alfresco-adf-app
 
 If you have an earlier version of the generator installed then it usually a good idea to uninstall it before reinstalling the latest version. This is especially true if you installed the generator packages before ADF 2.0 because the packages were renamed for this version.
 
 Uninstall previous versions with:
 
-	sudo npm uninstall generator-alfresco-adf-app
+    sudo npm uninstall generator-alfresco-adf-app
 
 ...for versions after ADF 2.0 and:
 
-	sudo npm uninstall generator-ng2-alfresco-app
+    sudo npm uninstall generator-ng2-alfresco-app
 
 ...for versions before ADF 2.0.	
 
diff --git a/docs/tutorials/working-with-data-table.md b/docs/tutorials/working-with-data-table.md
index 1abb5ce5cf..c5bf39fb4d 100644
--- a/docs/tutorials/working-with-data-table.md
+++ b/docs/tutorials/working-with-data-table.md
@@ -5,24 +5,26 @@ Level: Intermediate
 
 # Working with a Data Table
 
-In this tutorial you will learn how to populate a [`DataTable` component](https://alfresco.github.io/adf-component-catalog/components/DataTableComponent.html) with custom data from a generic back-end service or third party API. As an example we are going to use data from one of the available services on Alfresco Content Services. However, the procedure is much the same if want to use an Alfresco Process Services endpoint or a third party API.
+In this tutorial you will learn how to populate a DataTable component.
+
+The custom data for the table generally comes from a generic back-end service or third party API. As an example we are going to use data from one of the available services on Alfresco Content Services. However, the procedure is much the same if want to use an Alfresco Process Services endpoint or a third party API.
 
 ## Prerequisites and data source
 
 Before diving deep into the technical description of the
-[`DataTable` component](https://alfresco.github.io/adf-component-catalog/components/DataTableComponent.html),
+[DataTable component](../core/datatable.component.md),
 let's start with a description of the development environment and its prerequisites.
 
 In this tutorial we will start from an existing ADF application set up to use (at least) Alfresco Content
 Services as a service layer. For convenience and relevance to the Data Table, we suggest using the
 [Alfresco Example Content Application](https://github.com/Alfresco/alfresco-content-app). This application
-is well documented [here](https://alfresco.github.io/alfresco-content-app/#/), and you can choose to
+is well documented, and you can choose to
 [build it from the source code](https://alfresco.github.io/alfresco-content-app/#/build) or
 [run it in a Docker container](https://alfresco.github.io/alfresco-content-app/#/docker).
 However, if you prefer to create a brand new ADF application from scratch then you should still be able
 to follow the tutorial without difficulty.
 
-For this tutorial, the endpoint used to populate the [Data Table component](../../lib/core/datatable/components/datatable/datatable.component.ts) is the
+For this tutorial, the endpoint used to populate the [DataTable component](../../lib/core/datatable/components/datatable/datatable.component.ts) is the
 [`/people` service](https://api-explorer.alfresco.com/api-explorer/#!/people/listPeople) which lists
 all users available in an Alfresco Content Services instance. The `/people` service is suitable for the
 purpose of this tutorial because it is available by default in the Alfresco Content Services REST API.
@@ -169,7 +171,7 @@ of the DataTable, and even smaller components like Attachment List, Comment List
 Content Selector are also based on it.
 
 Looking at the
-[documentation](https://alfresco.github.io/adf-component-catalog/components/DataTableComponent.html),
+[documentation](../core/datatable.component.md),
 we can see that it has a lot of different options, including single/multi selection, click events,
 context menus, actions and keyboard navigation.
 
@@ -199,7 +201,7 @@ access to all the data in the row, if required. When you click a row, you should
 ## DataTable columns
 
 Let's dig a bit deeper into the different options for rendering columns within the DataTable. The documentation for the
-[Data Column component](https://alfresco.github.io/adf-component-catalog/components/DataColumnComponent.html)
+[Data Column component](../core/data-column.component.md)
 is quite in-depth and has lots of examples. We highly recommend checking it out.
 
 From the documentation we can see that the [Data Column component](../core/data-column.component.md) has quite a few properties but the
diff --git a/docs/tutorials/working-with-nodes-js-api.md b/docs/tutorials/working-with-nodes-js-api.md
index 47b73e2858..d0ef9e5f6e 100644
--- a/docs/tutorials/working-with-nodes-js-api.md
+++ b/docs/tutorials/working-with-nodes-js-api.md
@@ -5,7 +5,9 @@ Level: Intermediate
 
 # Working with Nodes using the JS API
 
-In this tutorial you will learn how to use the [`AlfrescoCoreRestApi`](https://github.com/Alfresco/alfresco-js-api/tree/master/src/alfresco-core-rest-api). We have developed some practical examples to show you how to interact with an instance of Alfresco Content Services without using the REST endpoints directly. With this approach the `AlfrescoCoreRestApi` is used as an abstraction layer, defining one of the core services of the [`alfresco-api-js`](https://github.com/Alfresco/alfresco-js-api) library.
+In this tutorial you will learn how to use the [`AlfrescoCoreRestApi`](https://github.com/Alfresco/alfresco-js-api/tree/master/src/alfresco-core-rest-api).
+
+We have developed some practical examples to show you how to interact with an instance of Alfresco Content Services without using the REST endpoints directly. With this approach the `AlfrescoCoreRestApi` is used as an abstraction layer, defining one of the core services of the [`alfresco-api-js`](https://github.com/Alfresco/alfresco-js-api) library.
 
 ## Preparing the development environment
 
diff --git a/docs/user-guide/README.md b/docs/user-guide/README.md
index 240543ebe8..a0425ccfd4 100644
--- a/docs/user-guide/README.md
+++ b/docs/user-guide/README.md
@@ -13,7 +13,6 @@ on an item below to see the corresponding guide page.
 -   [Angular Material Design](angular-material-design.md)
 -   [Form Extensibility and Customisation](extensibility.md)
 -   [Internationalization in ADF](internationalization.md)
--   [App extensions](app-extensions.md)
 -   [Theming](theming.md)
 -   [Transclusion](transclusion.md)
 -   [Typography](typography.md)
diff --git a/docs/user-guide/angular-material-design.md b/docs/user-guide/angular-material-design.md
index 142960457d..ba0d1f3a63 100644
--- a/docs/user-guide/angular-material-design.md
+++ b/docs/user-guide/angular-material-design.md
@@ -4,6 +4,8 @@ Title: Angular Material Design
 
 # Angular Material Design
 
+This page describes the Angular Material Design library and how it is used in ADF.
+ 
 Google's
 [Material Design](https://material.io/guidelines/material-design/introduction.html)
 is an example of a _design language_, a
diff --git a/docs/user-guide/app-extensions.md b/docs/user-guide/app-extensions.md
index 9e6c845221..e22f167f56 100644
--- a/docs/user-guide/app-extensions.md
+++ b/docs/user-guide/app-extensions.md
@@ -45,7 +45,7 @@ a place in the app where the actual content will be supplied dynamically.
 ADF provides a number of features that offer extension points or help
 with extensibility in general:
 
--   **Components**: The [Dynamic component](../extensions/dynamic.component.md) and Dynamic Tab component
+-   **Components**: The [Dynamic component](../extensions/dynamic.component.md) and [Dynamic Tab component](../extensions/dynamic-tab.component.md)
     have no content of their own but they have an `id` property that
     references a registered component extension ID. The referenced component
     will be added as a child of the Dynamic component at runtime.
@@ -79,7 +79,7 @@ with extensibility in general:
 ## Setting up an app for extensibility
 
 You can register component classes for use with the [Dynamic component](../extensions/dynamic.component.md)
-or Dynamic Tab component using the `setComponents` method of the
+or [Dynamic Tab component](../extensions/dynamic-tab.component.md) using the `setComponents` method of the
 [Extension service](../extensions/extension.service.md) (see the Dynamic component page for further details
 and code samples). The service also has `setAuthGuards` and
 `setEvaluators` methods that behave analogously.
@@ -174,7 +174,7 @@ The `actions` array has the following structure:
 ```
 
 The [Extension service](../extensions/extension.service.md) defines a `getActionById` method that returns an
-`ActionRef` object corresponding to an item from this array.
+[`ActionRef`](../../lib/extensions/src/lib/config/action.extensions.ts) object corresponding to an item from this array.
 
 The `type` property refers to an action type that must be provided by the
 app (eg, the "SNACKBAR_INFO" in the example presumably just shows a standard snackbar
diff --git a/docs/user-guide/extensibility.md b/docs/user-guide/extensibility.md
index c5ac481a50..c63f1b179f 100644
--- a/docs/user-guide/extensibility.md
+++ b/docs/user-guide/extensibility.md
@@ -5,6 +5,8 @@ Added: v2.0.0
 
 # Form Extensibility and Customization
 
+This page describes how you can customize ADF forms to your own specification.
+
 _Note: it is assumed you are familiar with Alfresco Process Services (powered by Activiti) form definition structure._
 
 -   How components and widgets are rendered on a [`Form`](../../lib/process-services/task-list/models/form.model.ts)
diff --git a/docs/user-guide/internationalization.md b/docs/user-guide/internationalization.md
index 635cc98be7..ebc55747f1 100644
--- a/docs/user-guide/internationalization.md
+++ b/docs/user-guide/internationalization.md
@@ -7,7 +7,9 @@ Added: v2.2.0
 
 Internationalization (abbreviated to i18n) is the process of providing UI messages
 and captions in different human languages to make them easier for readers of those
-languages to understand. ADF provides full support for i18n in apps. The process does
+languages to understand.
+
+ADF provides full support for i18n in apps. The process does
 require some extra effort in planning and designing the UI but once implemented, it is
 fairly straightforward to maintain.
 
@@ -236,20 +238,20 @@ preferences can only be saved by the app when it runs, they will not immediately
 the app launches for the first time. The app uses the following priorities to determine
 the locale language for the first launch:
 
-1. If the `locale` property is set in `app.config.json` then this will be used.
-1. If there is no `locale` property then the browser's language setting will be used instead.
-1. If neither of the first two options is available then English will be used by default.
+1.  If the `locale` property is set in `app.config.json` then this will be used.
+2.  If there is no `locale` property then the browser's language setting will be used instead.
+3.  If neither of the first two options is available then English will be used by default.
 
 The table below illustrates how the selection is made:
 
 | User Preference | `locale` in `app.config.json` | Browser language | Default | Result |
-| -- | -- | -- | -- | -- |
+| --------------- | ----------------------------- | ---------------- | ------- | ------ |
 | X | X | X | en | en |
 | X | X | jp | en | jp |
 | X | fr | jp | en | fr |
 | it | fr | jp | en | it |
 
-The translation service probes the browser culture first, for example `en-GB`.
+The [translation service](../core/translation.service.md) probes the browser culture first, for example `en-GB`.
 If the `en-GB.json` file does not exist, the service falls back to the language id: `en`.
 
 Once the locale language is determined, it is saved to the user preferences and this saved value
diff --git a/docs/user-guide/metadata-indicators.md b/docs/user-guide/metadata-indicators.md
index 6d32e6bf22..1c0baacb3f 100644
--- a/docs/user-guide/metadata-indicators.md
+++ b/docs/user-guide/metadata-indicators.md
@@ -57,9 +57,9 @@ The component will expose a `metadata` property we can use from the outside and
 
 ```html
 <adf-metadata-icons [metadata]="nodeMetadata"></adf-metadata-icons>
-``` 
+```
 
-As you have seen earlier the DataColumn binds to `properties` property of the node, and maps the runtime value as the `value` local variable within the template. 
+As you have seen earlier the [`DataColumn`](../../lib/core/datatable/data/data-column.model.ts) binds to `properties` property of the node, and maps the runtime value as the `value` local variable within the template. 
 Next we propagate the `value` reference to the `<adf-metadata-icons>` component as `metadata` property.
 
 ```html
@@ -142,4 +142,4 @@ export class MetadataIconsComponent {
 
 <!-- {% endraw %} -->
 
-You can use this idea to build more complex indication experience based on the actual metadata state. 
\ No newline at end of file
+You can use this idea to build more complex indication experience based on the actual metadata state. 
diff --git a/docs/user-guide/theming.md b/docs/user-guide/theming.md
index dd4fae5749..380e984d23 100644
--- a/docs/user-guide/theming.md
+++ b/docs/user-guide/theming.md
@@ -5,6 +5,8 @@ Added: v2.0.0
 
 # Theming an ADF app
 
+**Theming** is the process of adding your own color scheme to add style to an existing design.
+
 The [Material Design](https://material.io/guidelines/material-design/introduction.html)
 specification doesn't specify a single color scheme. Instead it uses the concept
 of color **themes** to allow designers some flexibility in their choice of colors.
diff --git a/docs/user-guide/transclusion.md b/docs/user-guide/transclusion.md
index 4e0d3af1c5..dc03117ccc 100644
--- a/docs/user-guide/transclusion.md
+++ b/docs/user-guide/transclusion.md
@@ -6,7 +6,9 @@ Added: v2.6.0
 # Transclusion
 
 Several components in ADF make use of **transclusion**, which is the technique
-of incorporating user-supplied content in the body of a standard component. In
+of incorporating user-supplied content in the body of a standard component.
+
+In
 most cases, this is used to make small customizations (for example, the various
 list components let you supply custom content to show when the list is empty).
 However, there are also a few "containers" whose entire content is set by the user
diff --git a/docs/user-guide/typography.md b/docs/user-guide/typography.md
index 25ce450a7c..271c4f3c52 100644
--- a/docs/user-guide/typography.md
+++ b/docs/user-guide/typography.md
@@ -5,9 +5,7 @@ Added: v2.0.0
 
 # ADF Typography
 
-## What is typography?
-
-Typography configuration lets you change the style of the text in your ADF app
+Typography configuration lets you change the style of the text in your ADF app.
 
 ## Customization