Clarify driver-specific build and app tutorials

Make sequence explicit in "run code" step

Fixes cockroachdb#1215

Author: Jesse Seldess

build-a-c++-app-with-cockroachdb.md

@@ -21,11 +21,13 @@ Install the C++ libpqxx driver as described in the [official documentation](http
 
 ## Step 5. Run the C++ code
 
+Now that you have a database and a user, you'll run code to create a table and insert some rows, and then you'll run code to read and update values as an atomic [transaction](transactions.html).
+
 ### Basic Statements
 
-The following code connects as the `maxroach` user and executes some basic SQL statements, creating a table, inserting rows, and reading and printing the rows.
+First, use the following code to connect as the `maxroach` user and execute some basic SQL statements, creating a table, inserting rows, and reading and printing the rows.
 
-Copy the code or
+You can copy the code or
 <a href="https://raw.githubusercontent.com/cockroachdb/docs/gh-pages/_includes/app/basic-sample.cpp" download>download it directly</a>.
 
 ~~~ cpp
@@ -34,18 +36,17 @@ Copy the code or
 
 ### Transaction (with retry logic)
 
-The following code again connects as the `maxroach` user but this time executes a batch of statements as an atomic transaction to transfer funds from one account to another, where all included statements are either committed or aborted.
-
-Copy the code or
-<a href="https://raw.githubusercontent.com/cockroachdb/docs/gh-pages/_includes/app/txn-sample.cpp" download>download it directly</a>.
+Next, use the following code to again connect as the `maxroach` user but this time execute a batch of statements as an atomic transaction to transfer funds from one account to another, where all included statements are either committed or aborted.
 
 {{site.data.alerts.callout_info}}Because the CockroachDB transaction model requires the client to initiate retries in the case of contention, CockroachDB provides a generic <strong>retry function</strong> that runs inside a transaction and retries it as needed. You can copy and paste the retry function from here into your code. For more details, see <a href="https://www.cockroachlabs.com/docs/transactions.html#transaction-retries">Transaction Retries</a>.{{site.data.alerts.end}}
 
+You can copy the code or <a href="https://raw.githubusercontent.com/cockroachdb/docs/gh-pages/_includes/app/txn-sample.cpp" download>download it directly</a>.
+
 ~~~ cpp
 {% include app/txn-sample.cpp %}
 ~~~
 
-After running the code, to verify that funds were, in fact, transferred from one account to another, you can again use the [built-in SQL client](use-the-built-in-sql-client.html):
+After running the code, use the [built-in SQL client](use-the-built-in-sql-client.html) to verify that funds were transferred from one account to another:
 
 ~~~ shell
 $ cockroach sql -e 'SELECT id, balance FROM accounts' --database=bank

build-a-clojure-app-with-cockroachdb.md

@@ -34,9 +34,11 @@ CREATE TABLE
 
 ## Step 6. Run the Clojure code
 
+Now that you have a database and a user, you'll run code to create a table and insert some rows, and then you'll run code to read and update values as an atomic [transaction](transactions.html).
+
 ### Basic Statements
 
-The following code connects as the `maxroach` user and executes some basic SQL statements, inserting rows and reading and printing the rows.
+First, use the following code to connect as the `maxroach` user and execute some basic SQL statements, inserting rows and reading and printing the rows.
 
 Copy the code or
 <a href="https://raw.githubusercontent.com/cockroachdb/docs/gh-pages/_includes/app/basic-sample.clj" download>download it directly</a>.
@@ -47,7 +49,7 @@ Copy the code or
 
 ### Transaction (with retry logic)
 
-The following code again connects as the `maxroach` user but this time executes a batch of statements as an atomic transaction to transfer funds from one account to another, where all included statements are either committed or aborted.
+Next, use the following code to again connect as the `maxroach` user but this time execute a batch of statements as an atomic transaction to transfer funds from one account to another, where all included statements are either committed or aborted.
 
 Copy the code or
 <a href="https://raw.githubusercontent.com/cockroachdb/docs/gh-pages/_includes/app/txn-sample.clj" download>download it directly</a>.
@@ -58,7 +60,7 @@ Copy the code or
 {% include app/txn-sample.clj %}
 ~~~
 
-After running the code, to verify that funds were, in fact, transferred from one account to another, you can again use the [built-in SQL client](use-the-built-in-sql-client.html):
+After running the code, use the [built-in SQL client](use-the-built-in-sql-client.html) to verify that funds were transferred from one account to another:
 
 ~~~ shell
 $ cockroach sql -e 'SELECT id, balance FROM accounts' --database=bank

build-a-go-app-with-cockroachdb.md

@@ -30,13 +30,14 @@ $ go get -u github.com/lib/pq
 
 ## Step 5. Run the Go code
 
+Now that you have a database and a user, you'll run code to create a table and insert some rows, and then you'll run code to read and update values as an atomic [transaction](transactions.html).
+
 ### Basic Statements
 
-The following code connects as the `maxroach` user and executes some basic SQL statements, creating a table, inserting rows, and reading and printing the rows.
+First, use the following code to connect as the `maxroach` user and execute some basic SQL statements, creating a table, inserting rows, and reading and printing the rows.
 
 Copy the code or
 <a href="https://raw.githubusercontent.com/cockroachdb/docs/gh-pages/_includes/app/basic-sample.go" download>download it directly</a>.
-
 ~~~ go
 {% include app/basic-sample.go %}
 ~~~
@@ -57,7 +58,7 @@ Initial balances:
 
 ### Transaction (with retry logic)
 
-The following code again connects as the `maxroach` user but this time executes a batch of statements as an atomic transaction to transfer funds from one account to another, where all included statements are either committed or aborted.
+Next, use the following code to again connect as the `maxroach` user but this time will execute a batch of statements as an atomic transaction to transfer funds from one account to another, where all included statements are either committed or aborted.
 
 Copy the code or
 <a href="https://raw.githubusercontent.com/cockroachdb/docs/gh-pages/_includes/app/txn-sample.go" download>download it directly</a>.
@@ -86,7 +87,7 @@ The output should just be:
 Success
 ~~~
 
-However, if you want to verify that funds were, in fact, transferred from one account to another, you can again use the [built-in SQL client](use-the-built-in-sql-client.html):
+However, if you want to verify that funds were transferred from one account to another, use the [built-in SQL client](use-the-built-in-sql-client.html):
 
 ~~~ shell
 $ cockroach sql -e 'SELECT id, balance FROM accounts' --database=bank

build-a-java-app-with-cockroachdb.md

@@ -26,11 +26,13 @@ Download and set up the Java jdbc driver as described in the [official documenta
 
 ## Step 5. Run the Java code
 
+Now that you have a database and a user, you'll run code to create a table and insert some rows, and then you'll run code to read and update values as an atomic [transaction](transactions.html).
+
 ### Basic Statements
 
-The following code connects as the `maxroach` user and executes some basic SQL statements, creating a table, inserting rows, and reading and printing the rows.
+First, use the following code to connect as the `maxroach` user and execute some basic SQL statements, creating a table, inserting rows, and reading and printing the rows.
 
-Copy the code or
+You can copy the code or
 <a href="https://raw.githubusercontent.com/cockroachdb/docs/gh-pages/_includes/app/BasicSample.java" download>download it directly</a>.
 
 ~~~ java
@@ -39,9 +41,9 @@ Copy the code or
 
 ### Transaction (with retry logic)
 
-The following code again connects as the `maxroach` user but this time executes a batch of statements as an atomic transaction to transfer funds from one account to another, where all included statements are either committed or aborted.
+Next, use the following code to again connect as the `maxroach` user but this time execute a batch of statements as an atomic transaction to transfer funds from one account to another, where all included statements are either committed or aborted.
 
-Copy the code or
+You can copy the code or
 <a href="https://raw.githubusercontent.com/cockroachdb/docs/gh-pages/_includes/app/txn-sample.rb" download>download it directly</a>.
 
 {{site.data.alerts.callout_info}}Because the CockroachDB transaction model requires the client to initiate retries in the case of contention, CockroachDB provides a generic <strong>retry function</strong> that runs inside a transaction and retries it as needed. You can copy and paste the retry function from here into your code. For more details, see <a href="https://www.cockroachlabs.com/docs/transactions.html#transaction-retries">Transaction Retries</a>.{{site.data.alerts.end}}
@@ -50,7 +52,7 @@ Copy the code or
 {% include app/TxnSample.java %}
 ~~~
 
-After running the code, to verify that funds were, in fact, transferred from one account to another, you can again use the [built-in SQL client](use-the-built-in-sql-client.html):
+After running the code, use the [built-in SQL client](use-the-built-in-sql-client.html) to verify that funds were transferred from one account to another:
 
 ~~~ shell
 $ cockroach sql -e 'SELECT id, balance FROM accounts' --database=bank

build-a-nodejs-app-with-cockroachdb.md

@@ -30,11 +30,13 @@ $ npm install pg
 
 ## Step 5. Run the Node.js code
 
+Now that you have a database and a user, you'll run code to create a table and insert some rows, and then you'll run code to read and update values as an atomic [transaction](transactions.html).
+
 ### Basic Statements
 
-The following code connects as the `maxroach` user and executes some basic SQL statements, creating a table, inserting rows, and reading and printing the rows.
+First, use the following code to connect as the `maxroach` user and execute some basic SQL statements, creating a table, inserting rows, and reading and printing the rows.
 
-Copy the code or
+You can copy the code or
 <a href="https://raw.githubusercontent.com/cockroachdb/docs/gh-pages/_includes/app/basic-sample.js" download>download it directly</a>.
 
 ~~~ js
@@ -43,9 +45,9 @@ Copy the code or
 
 ### Transaction (with retry logic)
 
-The following code again connects as the `maxroach` user but this time executes a batch of statements as an atomic transaction to transfer funds from one account to another, where all included statements are either committed or aborted.
+Next, use the following code to again connect as the `maxroach` user but this time execute a batch of statements as an atomic transaction to transfer funds from one account to another, where all included statements are either committed or aborted.
 
-Copy the code or
+You can copy the code or
 <a href="https://raw.githubusercontent.com/cockroachdb/docs/gh-pages/_includes/app/txn-sample.js" download>download it directly</a>.
 
 {{site.data.alerts.callout_info}}Because the CockroachDB transaction model requires the client to initiate retries in the case of contention, CockroachDB provides a generic <strong>retry function</strong> that runs inside a transaction and retries it as needed. You can copy and paste the retry function from here into your code. For more details, see <a href="https://www.cockroachlabs.com/docs/transactions.html#transaction-retries">Transaction Retries</a>.{{site.data.alerts.end}}
@@ -54,7 +56,7 @@ Copy the code or
 {% include app/txn-sample.js %}
 ~~~
 
-After running the code, to verify that funds were, in fact, transferred from one account to another, you can again use the [built-in SQL client](use-the-built-in-sql-client.html):
+After running the code, use the [built-in SQL client](use-the-built-in-sql-client.html) to verify that funds were transferred from one account to another:
 
 ~~~ shell
 $ cockroach sql -e 'SELECT id, balance FROM accounts' --database=bank

build-a-php-app-with-cockroachdb.md

@@ -34,11 +34,13 @@ CREATE TABLE
 
 ## Step 6. Run the PHP code
 
+Now that you have a database and a user, you'll run code to create a table and insert some rows, and then you'll run code to read and update values as an atomic [transaction](transactions.html).
+
 ### Basic Statements
 
-The following code connects as the `maxroach` user and executes some basic SQL statements, inserting rows and reading and printing the rows.
+First, use the following code to connect as the `maxroach` user and execute some basic SQL statements, inserting rows and reading and printing the rows.
 
-Copy the code or
+You can copy the code or
 <a href="https://raw.githubusercontent.com/cockroachdb/docs/gh-pages/_includes/app/basic-sample.php" download>download it directly</a>.
 
 ~~~ php
@@ -47,9 +49,9 @@ Copy the code or
 
 ### Transaction (with retry logic)
 
-The following code again connects as the `maxroach` user but this time executes a batch of statements as an atomic transaction to transfer funds from one account to another, where all included statements are either committed or aborted.
+Next, use the following code to again connect as the `maxroach` user but this time execute a batch of statements as an atomic transaction to transfer funds from one account to another, where all included statements are either committed or aborted.
 
-Copy the code or
+You can copy the code or
 <a href="https://raw.githubusercontent.com/cockroachdb/docs/gh-pages/_includes/app/txn-sample.php" download>download it directly</a>.
 
 {{site.data.alerts.callout_info}}Because the CockroachDB transaction model requires the client to initiate retries in the case of contention, CockroachDB provides a generic <strong>retry function</strong> that runs inside a transaction and retries it as needed. You can copy and paste the retry function from here into your code. For more details, see <a href="https://www.cockroachlabs.com/docs/transactions.html#transaction-retries">Transaction Retries</a>.{{site.data.alerts.end}}
@@ -58,7 +60,7 @@ Copy the code or
 {% include app/txn-sample.php %}
 ~~~
 
-After running the code, to verify that funds were, in fact, transferred from one account to another, you can again use the [built-in SQL client](use-the-built-in-sql-client.html):
+After running the code, use the [built-in SQL client](use-the-built-in-sql-client.html) to verify that funds were transferred from one account to another:
 
 ~~~ shell
 $ cockroach sql -e 'SELECT id, balance FROM accounts' --database=bank

build-a-python-app-with-cockroachdb.md

@@ -39,9 +39,11 @@ For other ways to install psycopg2, see the [official documentation](http://init
 
 ## Step 5. Run the Python code
 
+Now that you have a database and a user, you'll run code to create a table and insert some rows, and then you'll run code to read and update values as an atomic [transaction](transactions.html).
+
 ### Basic Statements
 
-The following code connects as the `maxroach` user and executes some basic SQL statements, creating a table, inserting rows, and reading and printing the rows.
+First, use he following code to connect as the `maxroach` user and execute some basic SQL statements, creating a table, inserting rows, and reading and printing the rows.
 
 Copy the code or
 <a href="https://raw.githubusercontent.com/cockroachdb/docs/gh-pages/_includes/app/basic-sample.py" download>download it directly</a>.
@@ -66,7 +68,7 @@ Initial balances:
 
 ### Transaction (with retry logic)
 
-The following code again connects as the `maxroach` user but this time executes a batch of statements as an atomic transaction to transfer funds from one account to another, where all included statements are either committed or aborted.
+Next, use the following code to again connect as the `maxroach` user but this time execute a batch of statements as an atomic transaction to transfer funds from one account to another, where all included statements are either committed or aborted.
 
 Copy the code or
 <a href="https://raw.githubusercontent.com/cockroachdb/docs/gh-pages/_includes/app/txn-sample.py" download>download it directly</a>.
@@ -91,7 +93,7 @@ Balances after transfer:
 ['2', '350']
 ~~~
 
-However, if you want to verify that funds were, in fact, transferred from one account to another, you can again use the [built-in SQL client](use-the-built-in-sql-client.html):
+However, if you want to verify that funds were transferred from one account to another, use the [built-in SQL client](use-the-built-in-sql-client.html):
 
 ~~~ shell
 $ cockroach sql -e 'SELECT id, balance FROM accounts' --database=bank

build-a-ruby-app-with-cockroachdb.md

@@ -30,9 +30,11 @@ $ gem install pg
 
 ## Step 5. Run the Ruby code
 
+Now that you have a database and a user, you'll run code to create a table and insert some rows, and then you'll run code to read and update values as an atomic [transaction](transactions.html).
+
 ### Basic Statements
 
-The following code connects as the `maxroach` user and executes some basic SQL statements, creating a table, inserting rows, and reading and printing the rows.
+First, use the following code to connect as the `maxroach` user and execute some basic SQL statements, creating a table, inserting rows, and reading and printing the rows.
 
 Copy the code or
 <a href="https://raw.githubusercontent.com/cockroachdb/docs/gh-pages/_includes/app/basic-sample.rb" download>download it directly</a>.
@@ -57,7 +59,7 @@ Initial balances:
 
 ### Transaction (with retry logic)
 
-The following code again connects as the `maxroach` user but this time executes a batch of statements as an atomic transaction to transfer funds from one account to another, where all included statements are either committed or aborted.
+Next, use the following code to again connect as the `maxroach` user but this time execute a batch of statements as an atomic transaction to transfer funds from one account to another, where all included statements are either committed or aborted.
 
 Copy the code or
 <a href="https://raw.githubusercontent.com/cockroachdb/docs/gh-pages/_includes/app/txn-sample.rb" download>download it directly</a>.
@@ -74,7 +76,7 @@ Then run the code:
 $ ruby txn-sample.rb
 ~~~
 
-To verify that funds were, in fact, transferred from one account to another, you can again use the [built-in SQL client](use-the-built-in-sql-client.html):
+To verify that funds were transferred from one account to another, use the [built-in SQL client](use-the-built-in-sql-client.html):
 
 ~~~ shell
 $ cockroach sql -e 'SELECT id, balance FROM accounts' --database=bank