Merge pull request #849 from SachinAkash01/main

Refactor the Ballerina Docs for the Alfresco Connector

Author: daneshk

openapi/alfresco/Module.md

@@ -7,25 +7,30 @@ This Alfresco Content Services REST APIs enable you to access to the core featur
 
 Before using this connector in your Ballerina application, complete the following:
 
-* Create a [Alfresco Account](https://www.alfresco.com/try-alfresco-acs).
-* Obtain tokens by following [this guide](https://docs.alfresco.com/content-services/latest/develop/repo-ext-points/authentication/).
+* Create an [Alfresco Account](https://www.alfresco.com/try-alfresco-acs).
+* Once registered, you will receive an email with instructions to set up your Alfresco environment, including the default username and password. Use these credentials to access the Alfresco Content Services API.
+* Note: This connector only supports Basic Authentication (username/password) and does not require or support bearer tokens.
 
 ## Quickstart
 
 To use the Alfresco connector in your Ballerina application, update the .bal file as follows:
 
-### Step 1: Import connector
+### Step 1: Import the module
 First, import the `ballerinax/alfresco` module into the Ballerina project.
 ```ballerina
 import ballerinax/alfresco;
 ```
 
 ### Step 2: Create a new connector instance
-Create a `alfresco:ClientConfig` with the `Bearer_Token` obtained, and initialize the connector with it.
+Create a `alfresco:ConnectionConfig` using the Basic Authentication credentials (i.e: username and password), and initialize the connector with it.
 ```ballerina
-alfresco:ClientConfig clientConfig = {
+configurable string username = ?;
+configurable string password = ?;
+
+alfresco:ConnectionConfig clientConfig = {
     auth: {
-        token: <Bearer_Token>
+        username,
+        password
     }
 };
 alfresco:Client baseClient = check new (clientConfig, serviceURL);
@@ -35,14 +40,15 @@ alfresco:Client baseClient = check new (clientConfig, serviceURL);
 1. Now you can use the operations available within the connector. Note that they are in the form of remote operations.
 
     Following is an example on how to get list of comments in a particular node.
-
-    Retrieve list of comments in a particular node.
-
     ```ballerina
     public function main() returns error? {
         alfresco:CommentPaging response = check baseClient->listComments(nodeId);
         log:printInfo(response.toString());
     }
     ``` 
 
-2. Use `bal run` command to compile and run the Ballerina program.
+### Step 4: Run the Ballerina application
+Use the command below to run the Ballerina application
+```bash
+bal run
+```