diff --git a/ballerina/Package.md b/ballerina/Package.md
deleted file mode 100644
index 3453a00..0000000
--- a/ballerina/Package.md
+++ /dev/null
@@ -1,58 +0,0 @@
-## Overview
-This package provides an implementation to interact with MQTT servers via MQTT client and listener.
-
-MQTT is a lightweight, publish-subscribe, machine to machine network protocol for message queue/message queuing service.
-
-### Publisher and subscriber
-#### MQTT publisher
-A MQTT publisher is a MQTT client that publishes messages to the MQTT server. When working with a MQTT client, the first thing to do is to initialize the client.
-For the publisher to work successfully, an active MQTT server should be available.
-
-The code snippet given below initializes a publisher client with the basic configuration.
-```ballerina
-import ballerina/mqtt;
-import ballerina/uuid;
- 
-mqtt:ClientConfiguration clientConfiguration = {
-    connectionConfig: {
-        username: "ballerina",
-        password: "ballerinamqtt"
-    }
-};
-
-mqtt:Client mqttClient = check new (mqtt:DEFAULT_URL, uuid:createType1AsString(), clientConfiguration); // A unique id needs to be provided as the client id
-```
-Using the `publish` api of this client, messages can be sent to the MQTT server.
-```ballerina
-check mqttClient->publish("mqtt/test", {payload: "This is Ballerina MQTT client!!!".toBytes()});
-```
-#### MQTT subscriber
-A MQTT subscriber is a client responsible for reading messages from one or more topics in the server. When working with a MQTT subscriber, the first thing to do is initialize the subscriber.
-For the subscriber to work successfully, an active MQTT server should be available.
-
-The code snippet given below initializes a subscriber with the basic configuration.
-```ballerina
-mqtt:ListenerConfiguration listenerConfiguration = {
-    connectionConfig: {
-        username: "ballerina",
-        password: "ballerinamqtt"
-    },
-    manualAcks: false   // When set to false, the MQTT acknowledgements are not sent automatically by the subscriber
-};
-
-mqtt:Listener mqttSubscriber = check new (mqtt:DEFAULT_URL, uuid:createType1AsString(), "mqtt/test", listenerConfiguration);
-```
-This subscriber can be used in the `mqtt:Service` to listen to messages in `mqtt/test` topic.
-```ballerina
-service on mqttSubscriber {
-    remote function onMessage(mqtt:Message message, mqtt:Caller caller) returns error? {
-        log:printInfo(check string:fromBytes(message.payload));
-        check caller->complete();
-    }
-
-    remote function onError(mqtt:Error err) returns error? {
-        log:printError("Error occured ", err);
-    }
-}
-```
-The `mqtt:Caller` can be used to indicate that the application has completed processing the message by using `complete()` api.
diff --git a/ballerina/Module.md b/ballerina/README.md
similarity index 100%
rename from ballerina/Module.md
rename to ballerina/README.md