Update help and README.

Author: carlevison

README.md

@@ -12,17 +12,14 @@ Python 3.6 or later.  You can install Python from [https://www.python.org/](http
 
 ## Setup and Installation
 
-1. Set your account's CLOUDINARY_URL environment variable in your terminal configuration file.
-You can do this by adding `export <YOUR_ENVIRONMENT_VARIABLE>` to `~/.bash_profile` from the terminal. For example:
-    
-    ```
-    echo "export CLOUDINARY_URL=cloudinary://123456789012345:abcdefghijklmnopqrstuvwxyzA@cloud_name" >> ~/.bash_profile && source ~/.bash_profile
-    ```
+1. To install this package, run: `pip3 install cloudinary-cli`
+2. To make all your `cld` commands point to your Cloudinary account, set up your CLOUDINARY\_URL environment variable. For example:
+    * On Mac or Linux:<br>`export CLOUDINARY_URL=cloudinary://123456789012345:abcdefghijklmnopqrstuvwxyzA@cloud_name`
+    * On Windows:<br>`set CLOUDINARY_URL=cloudinary://123456789012345:abcdefghijklmnopqrstuvwxyzA@cloud_name`
 
 _**Note:** you can copy and paste your account environment variable from the Account Details section of the Dashboard page in the Cloudinary console._
 
-2. To install this package, run: `pip3 install cloudinary-cli`
-3. Make sure your configuration is set up properly by running `cld config`. A response of the following form is returned:
+3. Check your configuration by running `cld config`. A response of the following form is returned:
 
     ```
     cloud_name:     <CLOUD_NAME>
@@ -212,6 +209,8 @@ Whereas using the saved configuration "accountx":
 cld -C accountx admin usage
 ```
 
+_**Caution:** Creating a saved configuration may put your API secret at risk as it is stored in a local plain text file._
+
 You can create, delete and list saved configurations using the `config` command.
 
 ```
@@ -220,25 +219,6 @@ cld config [options]
 
 For details, see the [Cloudinary CLI documentation](https://cloudinary.com/documentation/cloudinary_cli#config).
 
-## Sample resources
-
-Creates a URL based on a sample resource from the demo account.
-
-Usage:
-
-```
-cld <sample_resource> <transformation>
-```
-
-- `sample` - http://res.cloudinary.com/demo/image/upload/sample
-- `couple` - http://res.cloudinary.com/demo/image/upload/couple
-- `dog` - http://res.cloudinary.com/demo/video/upload/dog
-
-Example: create the URL for the dog video with optimized quality.
-
-```
-cld dog q_auto
-```
 
 # TODOs
 - Globbing support

cloudinary_cli/cli.py

@@ -15,10 +15,9 @@
 
 
 @click.group(context_settings=CONTEXT_SETTINGS)
-@click.option("-c", "--config", help="""Temporary configuration to use. To use environment config:
-echo \"export CLOUDINARY_URL=YOUR_CLOUDINARY_URL\" >> ~/.bash_profile && source ~/.bash_profile
+@click.option("-c", "--config", help="""Tell the CLI which account to run the command on by specifying an account environment variable. 
 """)
-@click.option("-C", "--config_saved", help="""Saved configuration to use - see `config` command""")
+@click.option("-C", "--config_saved", help="""Tell the CLI which account to run the command on by specifying a saved configuration - see `config` command.""")
 @click_log.simple_verbosity_option(logger)
 def cli(config, config_saved):
     if config:

cloudinary_cli/core/admin.py

@@ -9,7 +9,7 @@
 @command("admin",
          short_help="Run any methods that can be called through the admin API.",
          help="""\b
-Enables you to run any methods that can be called through the admin API.
+Run any methods that can be called through the admin API.
 Format: cld <cli options> admin <command options> <method> <method parameters>
 \te.g. cld admin resources max_results=10 tags=sample
 \t      OR

cloudinary_cli/core/search.py

@@ -11,9 +11,9 @@
 
 
 @command("search",
-         short_help="Runs the admin API search method.",
+         short_help="Run the admin API search method.",
          help="""\b
-Runs the admin API search method.
+Run the admin API search method.
 Format: cld <cli options> search <command options> <Lucene query syntax string>
 e.g. cld search cat AND tags:kitten -s public_id desc -f context -f tags -n 10
 """)

cloudinary_cli/core/uploader.py

@@ -11,7 +11,7 @@
          short_help="Run any methods that can be called through the upload API.",
          help="""
 \b
-Enables you to run any methods that can be called through the upload API.
+Run any methods that can be called through the upload API.
 Format: cld <cli options> uploader <command options> <method> <method parameters>
 \te.g. cld uploader upload http://res.cloudinary.com/demo/image/upload/sample public_id=flowers invalidate=True
 \b

cloudinary_cli/core/utils.py

@@ -6,7 +6,7 @@
 from cloudinary_cli.utils import logger
 
 
-@command("url", help="Generates a Cloudinary URL, which you can optionally open in your browser.")
+@command("url", help="Generate a Cloudinary URL, which you can optionally open in your browser.")
 @argument("public_id", required=True)
 @argument("transformation", default="")
 @option("-rt", "--resource_type", default="image", type=Choice(['image', 'video', 'raw']), help="The asset type")

cloudinary_cli/modules/make.py

@@ -4,9 +4,9 @@
 from cloudinary_cli.utils import load_template
 
 
-@command("make", short_help="Scaffold Cloudinary templates.",
+@command("make", short_help="Return template code for implementing the specified Cloudinary widget.",
          help="""\b
-Returns template code for implementing the specified Cloudinary widget.
+Return template code for implementing the specified Cloudinary widget.
 e.g. cld make product_gallery
 """)
 @argument("template", nargs=-1)

cloudinary_cli/modules/sync.py

@@ -15,7 +15,7 @@
 
 
 @command("sync",
-         short_help="Synchronizes between a local directory and a Cloudinary folder.",
+         short_help="Synchronize between a local directory and a Cloudinary folder.",
          help="Synchronize between a local directory and a Cloudinary folder, maintaining the folder structure.")
 @argument("local_folder")
 @argument("cloudinary_folder")

cloudinary_cli/modules/upload_dir.py

@@ -10,7 +10,7 @@
 
 
 @command("upload_dir",
-         help="""Uploads a folder of assets, maintaining the folder structure.""")
+         help="""Upload a folder of assets, maintaining the folder structure.""")
 @argument("directory", default=".")
 @option("-o", "--optional_parameter", multiple=True, nargs=2, help="Pass optional parameters as raw strings.")
 @option("-O", "--optional_parameter_parsed",