Add example data to tutorial

docs/tutorial.txt

@@ -9,3 +9,4 @@ Tutorials
    /tutorial/commands
    /tutorial/gridfs
    /tutorial/indexes
+   /tutorial/example-data

docs/tutorial/example-data.md

-# Example Data
-
-Some examples in this documentation use example data fixtures from
-[zips.json][zips]. This is a dataset comprised of United States postal codes,
-populations, and geographic locations.
-
-Importing the dataset into MongoDB can be done in several ways. The following
-example uses [mongodb extension][ext-mongodb]:
-
-[zips]: http://media.mongodb.org/zips.json
-[ext-mongodb]: http://php.net/mongodb
-
-```
-<?php
-
-$file = 'http://media.mongodb.org/zips.json';
-$zips = file($file, FILE_IGNORE_NEW_LINES);
-
-$bulk = new MongoDB\Driver\BulkWrite;
-
-foreach ($zips as $string) {
-    $document = json_decode($string);
-    $bulk->insert($document);
-}
-
-$manager = new MongoDB\Driver\Manager('mongodb://localhost');
-
-$result = $manager->executeBulkWrite('demo.zips', $bulk);
-printf("Inserted %d documents\n", $result->getInsertedCount());
-```
-
-Executing this script should yield the following output:
-
-```
-Inserted 29353 documents
-```
-
-You may also import the dataset using the [mongoimport][mongoimport] command,
-which is included with MongoDB:
-
-[mongoimport]: http://docs.mongodb.org/manual/reference/program/mongoimport/
-
-```bash
-$ mongoimport --db demo --collection zips --file zips.json --drop
-```

docs/tutorial/example-data.txt

+============
+Example Data
+============
+
+.. default-domain:: mongodb
+
+Some examples in this documentation use example data fixtures from
+`zips.json <http://media.mongodb.org/zips.json>`_. This is a dataset comprised
+of United States postal codes, populations, and geographic locations.
+
+Importing the dataset into MongoDB can be done in several ways. The following
+example uses the :php:`driver <mongodb>` directly:
+
+.. code-block:: php
+
+   <?php
+
+   $file = 'http://media.mongodb.org/zips.json';
+   $zips = file($file, FILE_IGNORE_NEW_LINES);
+
+   $bulk = new MongoDB\Driver\BulkWrite;
+
+   foreach ($zips as $string) {
+       $document = json_decode($string);
+       $bulk->insert($document);
+   }
+
+   $manager = new MongoDB\Driver\Manager('mongodb://127.0.0.1/');
+
+   $result = $manager->executeBulkWrite('demo.zips', $bulk);
+   printf("Inserted %d documents\n", $result->getInsertedCount());
+
+The output would then resemble::
+
+   Inserted 29353 documents
+
+You may also import the dataset using :manual:`mongoimport
+</reference/program/mongoimport>`, which is included with MongoDB:
+
+.. code-block:: none
+
+   $ mongoimport --db demo --collection zips --file zips.json --drop