[MNT-24575] Added documentation

lib/content-services/src/lib/common/services/nodes-api.service.ts

@@ -257,10 +257,21 @@ export class NodesApiService {
         return this.createNodeInsideRoot(name || this.randomNodeName(), nodeType, properties, path);
     }
 
+    /**
+     * Initiate a new request to calculate folder size.
+     * @param nodeId Node Id
+     * @returns The job id which can be used to track request status
+     */
     initiateFolderSizeCalculation(nodeId: string): Observable<JobIdBodyEntry> {
         return from(this.nodesApi.initialFolderSizeCalculation(nodeId));
     }
 
+    /**
+     * Gets the size of a folder.
+     * @param nodeId Node Id
+     * @param jobId Job Id
+     * @returns Folder details
+     */
     getFolderSizeInfo(nodeId: string, jobId: string): Observable<SizeDetailsEntry> {
         return from(this.nodesApi.getFolderSizeInfo(nodeId, jobId));
     }

lib/js-api/src/api/content-rest-api/api/nodes.api.ts

@@ -985,6 +985,14 @@ export class NodesApi extends BaseApi {
         });
     }
 
+    /**
+     * Initiate a new request to calculate folder size.
+     *
+     * **Note:** this endpoint is available in Alfresco 7.1 and newer versions.
+     *
+     * @param nodeId Node Id
+     * @returns The job id which can be used to track request status
+     */
     initialFolderSizeCalculation(nodeId: string): Promise<JobIdBodyEntry> {
         throwIfNotDefined(nodeId, 'nodeId');
 
@@ -999,6 +1007,16 @@ export class NodesApi extends BaseApi {
         });
     }
 
+    /**
+     * Gets the size of a folder.
+     *
+     * **Note:** this endpoint is available in Alfresco 7.1 and newer versions.
+     *
+     * @param nodeId Node Id
+     * @param jobId Job Id
+     * @returns Folder details
+     */
+
     getFolderSizeInfo(nodeId: string, jobId: string): Promise<SizeDetailsEntry> {
         throwIfNotDefined(nodeId, 'nodeId');
         throwIfNotDefined(jobId, 'jobId');