Updated documentation, readme (#262)

* Updated documentation, readme

Author: pkittenis

README.rst

@@ -278,14 +278,5 @@ Directory recursion is supported in both cases via the ``recurse`` parameter - d
 See `SFTP and SCP documentation <https://parallel-ssh.readthedocs.io/en/latest/advanced.html#sftp-scp>`_ for more examples.
 
 
-*****************
-Design And Goals
-*****************
-
-``parallel-ssh``'s design goals and motivation are to provide a *library* for running *non-blocking* asynchronous SSH commands in parallel and on single hosts with little to no load induced on the system by doing so with the intended usage being completely programmatic and non-interactive.
-
-To meet these goals, API driven solutions are preferred first and foremost. This frees up developers to drive the library via any method desired, be that environment variables, CI driven tasks, command line tools, existing OpenSSH or new configuration files, from within an application et al.
-
-
 .. image:: https://ga-beacon.appspot.com/UA-9132694-7/parallel-ssh/README.rst?pixel
   :target: https://github.com/igrigorik/ga-beacon

doc/advanced.rst

@@ -181,7 +181,7 @@ Proxy host can be configured in Per-Host Configuration:
        HostConfig(proxy_host='127.0.0.3'),
        HostConfig(proxy_host='127.0.0.4'),
        ]
-   clieent = ParallelSSHClient(hosts, host_config=host_config)
+   client = ParallelSSHClient(hosts, host_config=host_config)
    output = client.run_command('echo me')
 
 See :py:mod:`HostConfig <pssh.config.HostConfig>` for all possible configuration.
@@ -274,7 +274,8 @@ In some cases, such as when the remote command never terminates unless interrupt
 .. code-block:: python
 
    output = client.run_command(
-       'while true; do echo a line; sleep .1; done', use_pty=True, read_timeout=1)
+       'while true; do echo a line; sleep .1; done',
+       use_pty=True, read_timeout=1)
 
    # Read as many lines of output as hosts have sent before the timeout
    stdout = []

doc/introduction.rst

@@ -18,3 +18,5 @@ Taking a cue from `PEP 20 <https://www.python.org/dev/peps/pep-0020/>`_, heavy e
 * Beautiful is better than ugly
 
 Contributions are asked to keep these in mind.
+
+In addition, a heavy emphasis is also given to test driven development. The library is continuously integration tested with a real SSH server (OpenSSH) and has very high code test coverage.