Documentation update for v0.1.

Author: Fizzadar

docs/building_a_deploy.rst

@@ -348,7 +348,7 @@ arguments:
 
     @hook.before_connect
     def my_callback(data, state):
-        print 'Before connect hook!'
+        print('Before connect hook!')
 
 To abort a deploy, a hook can raise a ``hook.Error`` which the CLI
 will handle.

docs/getting_started.rst

@@ -7,7 +7,7 @@ This guide should help describe the basics of deploying stuff with pyinfra.
 Install
 -------
 
-pyinfra requires `Python <https://python.org>`_ and can be installed with ``pip``:
+pyinfra requires `Python <https://python.org>`_ and can be installed with `pip <https://pip.pypa.io/en/stable/>`_:
 
 .. code:: bash
 
@@ -18,9 +18,9 @@ pyinfra requires `Python <https://python.org>`_ and can be installed with ``pip`
     Usage:
         pyinfra -i INVENTORY DEPLOY [-v -vv options]
         pyinfra -i INVENTORY --run OP ARGS [-v -vv options]
-        pyinfra -i INVENTORY --fact FACT [-v options]
-        pyinfra -i INVENTORY [DEPLOY] --debug-data [options]
-        pyinfra (--facts | --help | --version)
+        pyinfra -i INVENTORY --run COMMAND [-v -vv options]
+        pyinfra -i INVENTORY --fact FACT [-vv options]
+        ...
 
 
 Command Line Ops
@@ -29,8 +29,7 @@ Command Line Ops
 To deploy something with pyinfra, you need an **inventory** and some **operations**:
 
 + **The inventory** holds the target hosts, groups and any data associated with them
-+ **The operations** define the desired state of the target hosts, and are grouped as
-**modules**
++ **The operations** define the desired state of the target hosts, and are grouped as **modules**
 
 Lets start by running a deploy that will ensure user "fred" exists, using the ``server.user`` operation:
 

docs/modules/server.rst

@@ -56,8 +56,8 @@ Manage system users & their ssh `authorized_keys`. Options:
 .. code:: python
 
     server.user(
-        name, present=True, home=None, shell=None,
-        group=None, groups=None, public_keys=None, ensure_home=True, system=False
+        name, present=True, home=None, shell=None, group=None,
+        groups=None, public_keys=None, delete_keys=False, ensure_home=True, system=False
     )
 
 + **name**: name of the user to ensure
@@ -67,12 +67,13 @@ Manage system users & their ssh `authorized_keys`. Options:
 + **group**: the users primary group
 + **groups**: the users secondary groups
 + **public_keys**: list of public keys to attach to this user, ``home`` must be specified
++ **delete_keys**: whether to remove any keys not specified in ``public_keys``
 + **ensure_home**: whether to ensure the ``home`` directory exists
 + **system**: whether to create a system account
 
 Home directory:
     When ``ensure_home`` or ``public_keys`` are provided, ``home`` defaults to
-    ``/home/{name}``
+    ``/home/{name}``.
 
 
 :code:`server.wait`