diff --git a/README.md b/README.md
index 38a256b..a907b29 100644
--- a/README.md
+++ b/README.md
@@ -18,46 +18,34 @@ The Ballerina Discord connector offers APIs to connect and interact with the [Di
Follow these steps to create a Discord developer account.
### Step 1: Login to Discord developer page
-
-
-
+
Visit [Discord developer portal](https://discord.com/login?redirect_to=%2Fdevelopers) by logging into your Discord account.
If you do not have a Discord account already, [create a new discord account](https://discord.com/login) by clicking on the `Register` hyperlink below the `Log In` button when opening the Discord developer page.
-
-
-
Complete the account creation process by including the relevant information in the given fields.
### Step 2: Make a new Discord application
-
-
-
Once in the Discord developer portal is open, click on the `New Application` button as displayed above to start the process.
### Step 3: Name the Discord Application
-
-
-
+
1. Proceed by giving the Discord Application a name and click on the terms of service.
2. Finally complete the naming process by clicking on the `next` button.
### Step 4: Obtain the Client ID and Client Secret
-
-
-
+
Under the `OAuth2` section found on the left-sided list, locate the Client's Information as shown on the screen. To implement the functionalities provided by Discord's API, you will need the Client ID and Client Secret.
diff --git a/ballerina/Module.md b/ballerina/Module.md
index b787561..29a41db 100644
--- a/ballerina/Module.md
+++ b/ballerina/Module.md
@@ -9,46 +9,34 @@ The Ballerina Discord connector offers APIs to connect and interact with the [Di
Follow these steps to create a Discord developer account.
### Step 1: Login to Discord developer page
-
-
-
+
Visit [Discord developer portal](https://discord.com/login?redirect_to=%2Fdevelopers) by logging into your Discord account.
If you do not have a Discord account already, [create a new discord account](https://discord.com/login) by clicking on the `Register` hyperlink below the `Log In` button when opening the Discord developer page.
-
-
-
Complete the account creation process by including the relevant information in the given fields.
### Step 2: Make a new Discord application
-
-
-
Once in the Discord developer portal is open, click on the `New Application` button as displayed above to start the process.
### Step 3: Name the Discord Application
-
-
-
+
1. Proceed by giving the Discord Application a name and click on the terms of service.
2. Finally complete the naming process by clicking on the `next` button.
### Step 4: Obtain the Client ID and Client Secret
-
-
-
+
Under the `OAuth2` section found on the left-sided list, locate the Client's Information as shown on the screen. To implement the functionalities provided by Discord's API, you will need the Client ID and Client Secret.
diff --git a/ballerina/Package.md b/ballerina/Package.md
index b787561..29a41db 100644
--- a/ballerina/Package.md
+++ b/ballerina/Package.md
@@ -9,46 +9,34 @@ The Ballerina Discord connector offers APIs to connect and interact with the [Di
Follow these steps to create a Discord developer account.
### Step 1: Login to Discord developer page
-
-
-
+
Visit [Discord developer portal](https://discord.com/login?redirect_to=%2Fdevelopers) by logging into your Discord account.
If you do not have a Discord account already, [create a new discord account](https://discord.com/login) by clicking on the `Register` hyperlink below the `Log In` button when opening the Discord developer page.
-
-
-
Complete the account creation process by including the relevant information in the given fields.
### Step 2: Make a new Discord application
-
-
-
Once in the Discord developer portal is open, click on the `New Application` button as displayed above to start the process.
### Step 3: Name the Discord Application
-
-
-
+
1. Proceed by giving the Discord Application a name and click on the terms of service.
2. Finally complete the naming process by clicking on the `next` button.
### Step 4: Obtain the Client ID and Client Secret
-
-
-
+
Under the `OAuth2` section found on the left-sided list, locate the Client's Information as shown on the screen. To implement the functionalities provided by Discord's API, you will need the Client ID and Client Secret.