update description and readme file

Author: bassel-zeidan

python/README.md

@@ -32,7 +32,7 @@ within a DSX Jupyter notebook, you can obtain your account credentials in the fo
 If your Object Storage was created with a Softlayer account, each part of the credentials will
 be found as text that you can copy and paste into the example code below.
 
-### Softlayer Cloud Object Storage / Data Science Experience
+### Softlayer IBM Cloud Object Storage / Data Science Experience
 ```python
 import ibmos2spark
 
@@ -50,14 +50,13 @@ object_name = 'file1'
 data = sc.textFile(cos.url(object_name, bucket_name))
 ```
 
-### Bluemix Cloud Object Storage / Data Science Experience
+### Bluemix IBM Cloud Object Storage / Data Science Experience
 The class CloudObjectStorage allows you to connect to bluemix cos. You can connect to bluemix using api keys
 as follows:
 
-```pythonw
+```python
 import ibmos2spark
 
-# @hidden_cell
 credentials = {
     'endpoint': 'XXX',
     'api_key': 'XXX',
@@ -72,11 +71,10 @@ object_name = 'file_name'
 data = sc.textFile(cos.url(object_name, bucket_name))
 ```
 
-Alternatively, you can connect to bluemix cos using IAM token. Example:
-```pythonw
+Alternatively, you can connect to an IBM bluemix cos using IAM token. Example:
+```python
 import ibmos2spark
 
-# @hidden_cell
 credentials = {
     'endpoint': 'XXX',
     'iam_token': 'eyJraWQXXXX .... X',

python/ibmos2spark/osconfig.py

@@ -173,18 +173,18 @@ class CloudObjectStorage(object):
     def __init__(self, sparkcontext, credentials, configuration_name='', cos_type='softlayer_cos', auth_method='api_key', bucket_name=''):
 
         '''
-        This class allows you to connect to a cloud object storage (COS) instance. It also support connecting to a cos instance
+        This class allows you to connect to an IBM cloud object storage (COS) instance. It also support connecting to an IBM COS instance
         that is being hosted on bluemix.
 
         sparkcontext:  a SparkContext object.
 
         credentials:  a dictionary with the required keys to connect to cos. The required keys differ according
-            to the type of cos.
-            - for cos type "softlayer_cos" the following key are required:
+            to the type of COS.
+            - for COS type "softlayer_cos" the following key are required:
               * endpoint
               * access_key
               * secret_key
-            - for cos type "bluemix_cos", here are the required/optional key:
+            - for COS type "bluemix_cos", here are the required/optional key:
               * endpoint [required]
               * service_id [required]
               * api_key OR iam_token depends on the selected authorization method (auth_method) [required]
@@ -196,10 +196,10 @@ def __init__(self, sparkcontext, credentials, configuration_name='', cos_type='s
             multiple configurations to different Object Storage accounts.
             if a configuration name is not passed the default one will be used "service".
 
-        cos_type [optional]: string that identifies the type of cos to connect to. The supported types of cos
+        cos_type [optional]: string that identifies the type of COS to connect to. The supported types of COS
             are "softlayer_cos" and "bluemix_cos". "softlayer_cos" will be chosen as default if no cos_type is passed.
 
-        auth_method [optional]: string that identifies the type of authorization to use when connecting to cos. This parameter
+        auth_method [optional]: string that identifies the type of authorization to use when connecting to an IBM COS. This parameter
             is not reqired for softlayer_cos but only needed for bluemix_cos. Two options can be chosen for this params
             "api_key" or "iam_token". "api_key" will be chosen as default if the value is not set.