[ACS-7427] Process Services improvements and cleanup (#9664)

docs/core/services/comment-process.service.md

@@ -5,13 +5,11 @@ Status: Active
 Last reviewed: 2018-11-14
 ---
 
-# [Comment Process service](../../../lib/process-services/src/lib/process-comments/services/comment-process.service.ts "Defined in comment-process.service.ts")
+# Comment Process Service
 
 Adds and retrieves comments for task and process instances in Process Services.
 
-## Class members
-
-### Methods
+## API
 
 -   **add**(id: `string`, message: `string`): [`Observable`](http://reactivex.io/documentation/observable.html)`<`[`CommentModel`](../../../lib/core/src/lib/models/comment.model.ts)`>`<br/>
     Adds a comment to a process instance.
@@ -22,13 +20,7 @@ Adds and retrieves comments for task and process instances in Process Services.
     Gets all comments that have been added to a process instance.
     -   _id:_ `string`  - 
     -   **Returns** [`Observable`](http://reactivex.io/documentation/observable.html)`<`[`CommentModel`](../../../lib/core/src/lib/models/comment.model.ts)`[]>` - Details for each comment
--   **getUserImage**(user: `any`): `string`<br/>
-
-    -   _user:_ `any`  - 
-    -   **Returns** `string` -
-
-## Details
-
-See the Comments API section of the
-[Alfresco JS API docs](https://github.com/Alfresco/alfresco-js-api/tree/master/src/alfresco-activiti-rest-api)
-for further details about the underlying REST API.
+-   **getUserImage**(userId: `string`): `string`<br/>
+    Gets the URL for the user image.
+    -   _userId:_ `string`  - 
+    -   **Returns** `string` - URL for the user image