Updated Readme

Author: jexp

README.adoc

@@ -2,11 +2,18 @@
 
 image:https://travis-ci.org/neo4j-contrib/neo4j-script-procedures.svg?branch=3.1["Build Status", link="https://travis-ci.org/neo4j-contrib/neo4j-script-procedures"]
 
-This project demonstrates how to create dynamic procedures on top of Neo4j's built in ones.
-You can create javascript functions in your database that can be later run using the 'nashorn' engine.
+This project demonstrates how to create dynamic procedures and functions on top of Neo4j's built in infrastructure.
+
+You can create JavaScript functions in your database that can be later run using the 'nashorn' engine.
 
 [Note]
-This project requires a Neo4j 3.0.0 snapshot or milestone dependency.
+This project requires Neo4j 3.1.x (not 3.1.2 though)
+
+== Installation
+
+1. Download the jar from the http://github.com/neo4j-contrib/neo4j-script-procedures/releases/latest[latest release]
+2. Copy it into your `$NEO4J_HOME/plugins` directory.
+3. Restart your server.
 
 == Operations
 
@@ -24,19 +31,24 @@ CALL scripts.function({name}, {code})
 .run function as procedure
 [source,cypher]
 ----
-CALL scripts.run({name}, {params})
+CALL scripts.run({name}[, {params}])
 
 CALL scripts.run('users', null)
+CALL scripts.run('users')
 
 -> returns one user per row
 ----
 
 .run function as function
 [source,cypher]
 ----
-RETURN scripts.run({name}, {params})
+RETURN scripts.run({name}[, {params}])
+
+RETURN scripts.run('users', null) as users
+
+or
 
-RETURN scripts.run('users', null)
+RETURN scripts.run('users') as users
 
 -> returns a list of users
 ----
@@ -57,16 +69,15 @@ function type(s) { return org.neo4j.graphdb.RelationshipType.withName(s); }
 function collection(it) { r=[]; while (it.hasNext()) r.push(it.next());  return Java.to(r); }
 ----
 
-== Building
+== Building it yourself
 
 This project uses maven, to build a jar-file with the procedure in this
 project, simply package the project with maven:
 
     mvn clean package
 
-This will produce a jar-file,`target/neo4j-javascript-procs-1.0.0-SNAPSHOT.jar`,
-that can be deployed in the `plugin` directory of your Neo4j instance.
+This will produce a jar-file,`target/neo4j-script-procedures-1.0.0-SNAPSHOT.jar`, that can be copied in the `$NEO4J_HOME/plugins` directory of your Neo4j instance.
 
 == License
 
-Apache License V2, see LICENSE
+Apache License V2, see LICENSE