doc: small convergence between the readme and the full doc

A torough backport of recent README entries remain
to be done.
2 files changed, 9 insertions(+), 3 deletions(-)

M README.md
M doc/index.rst
M README.md +5 -2
@@ 1,8 1,11 @@ 
 # REWORK
 
-This is a python task scheduling and execution tool, which needs only
-python and Postgres to work.
+`rework` is a distributed execution system for the execution of tasks
+that can belong to independant python environments and code bases,
+even hosted on different computers.
 
+The only constraint is that postgres must be accessible from all nodes
+of a given `rework` installation.
 
 ## Principles
 

          
M doc/index.rst +4 -1
@@ 104,7 104,7 @@ This being done, we can start writing ou
            print('I am done')
 
 
-   if __name__ == '__main__':
+   def main(uri):
        engine = create_engine(
            'postgres://babar:password@localhost/jobstore'
        )

          
@@ 119,6 119,9 @@ This being done, we can start writing ou
        assert t1.output == 'hellohello'
        assert t2.output == 200
 
+  if __name__ == '__main__':
+      main('postgres://babar:password@localhost:5432/jobstore')
+
 
 Here we have defined a dummy task that will print a bunch of
 sentences, doubler the input value and save a result back.