Improve docstrings

syncano_cli/base/exceptions.py

@@ -23,11 +23,11 @@ class JSONParseException(CLIBaseException):
 
 
 class BadCredentialsException(CLIBaseException):
-    default_message = u'Wrong credential provided when login.'
+    default_message = u'Wrong login credentials provided.'
 
 
 class NotLoggedInException(CLIBaseException):
-    default_message = u'Do a login first: `syncano login`.'
+    default_message = u'Please log in to your account: `syncano login`.'
 
 
 class InstanceNotFoundException(CLIBaseException):

syncano_cli/custom_sockets/commands.py

@@ -18,7 +18,7 @@ def top_sockets():
 @click.option('--instance-name', help=u'Instance name.')
 def sockets(ctx, config, instance_name):
     """
-    Allow to create a custom socket.
+    Create and manage custom sockets.
     """
     instance = get_instance(config, instance_name)
     socket_command = SocketCommand(instance=instance)

syncano_cli/instance/commands.py

@@ -18,7 +18,9 @@ def top_instance():
 @click.option('--instance-name', help=u'Instance name.')
 def instances(ctx, config, instance_name):
     """
-    Handle hosting and hosting files. Allow to publish static pages to the Syncano Hosting.
+    Mangage your Instances. Instance is an equivalent of a project or a set of data.
+    It contains information about Sockets, Data Classes, Data Objects and more.
+    You can own and/or belong to multiple instances.
     """
     connection = create_connection(config, instance_name)
     instance_commands = InstanceCommands(connection)

syncano_cli/parse_to_syncano/commands.py

@@ -16,7 +16,7 @@ def top_migrate():
 @click.option('--config', help=u'Account configuration file.')
 def migrate(context, config):
     """
-    Command for transfer data to Syncano
+    Migrate Parse data to Syncano
     """
     config = config or ACCOUNT_CONFIG_PATH
     context.obj['config'] = config
@@ -26,7 +26,7 @@ def migrate(context, config):
 @click.pass_context
 def parse(context):
     """
-        Synchronize the parse data object with syncano data objects;
+        Synchronize the Parse data objects with Syncano data objects;
         """
     config = read_config(config_path=context.obj['config'])
     check_configuration(config, silent=True)
@@ -53,7 +53,7 @@ def parse(context):
 @click.option('--force', is_flag=True, default=False, help="Force to overwrite previous config.")
 def configure(context, current, force):
     """
-    Configure the data needed for connection to the parse and syncano;
+    Configure the data needed for connection between Parse and Syncano;
     """
     config = read_config(config_path=context.obj['config'])
     if current:

syncano_cli/sync/commands.py

@@ -23,7 +23,7 @@ def top_sync():
 @click.option('--instance-name', help=u'Instance name.')
 def sync(context, file, config, instance_name):
     """
-    Command for syncing data - classes and scripts
+    Sync your scripts and data classes.
     :param context:
     :param file: file which will be used for syncing
     :param config: the config path - the cli config will be stored there