diff --git a/examples/deployment_create.py b/examples/deployment_create.py
index ba13440ff..e17af3b5c 100644
--- a/examples/deployment_create.py
+++ b/examples/deployment_create.py
@@ -12,6 +12,10 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+"""
+Creates a deployment using AppsV1Api from file nginx-deployment.yaml.
+"""
+
 from os import path
 
 import yaml
diff --git a/examples/remote_cluster.py b/examples/remote_cluster.py
index a09e7ed9b..84ebeb4f6 100644
--- a/examples/remote_cluster.py
+++ b/examples/remote_cluster.py
@@ -12,9 +12,11 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# This example demonstrate communication with a remote Kube cluster from a
-# server outside of the cluster without kube client installed on it.
-# The communication is secured with the use of Bearer token.
+"""
+This example demonstrates the communication between a remote cluster and a
+server outside the cluster without kube client installed on it.
+The communication is secured with the use of Bearer token.
+"""
 
 from kubernetes import client, config