Added the Getting Started section to the documentation

JAVA-1701

Author: rozza

docs/reference/content/getting-started/index.md

@@ -0,0 +1,15 @@
++++
+date = "2015-03-17T15:36:56Z"
+title = "Getting Started"
+[menu.main]
+  weight = 10
+  pre = "<i class='fa fa-road'></i>"
++++
+
+## Getting Started
+
+To help you get started quickly on the new driver, follow:
+
+  * [Installation]({{< ref "getting-started/installation-guide.md" >}})
+  * [Quick Tour]({{< ref "getting-started/quick-tour.md" >}})
+  * [Admin Quick Tour]({{< ref "getting-started/quick-tour-admin.md" >}})

docs/reference/content/tutorial/installation-guide.md renamed to docs/reference/content/getting-started/installation-guide.md

@@ -0,0 +1,164 @@
++++
+date = "2015-03-17T15:36:56Z"
+title = "Admin Quick Tour"
+[menu.main]
+  parent = "Getting Started"
+  weight = 20
+  pre = "<i class='fa'></i>"
++++
+
+# MongoDB Driver Admin Quick Tour
+
+This is the second part of the MongoDB driver quick tour. In the
+[quick tour]({{< relref "getting-started/quick-tour.md" >}}) we looked at how to
+use the Java driver to execute basic CRUD operations.  In this section we'll look at some of the
+administrative features available in the driver.
+
+The following code snippets come from the `QuickTourAdmin.java` example code
+that can be found with the [driver
+source]({{< srcref "driver/src/examples/tour/QuickTourAdmin.java">}}).
+
+{{% note %}}
+See the [installation guide]({{< relref "getting-started/installation-guide.md" >}})
+for instructions on how to install the MongoDB Driver.
+{{% /note %}}
+
+## Setup
+
+To get use started we'll quickly connect and create a `mongoClient`, `database` and `collection`
+variable for use in the examples below:
+
+```java
+MongoClient mongoClient = new MongoClient();
+MongoDatabase database = mongoClient.getDatabase("mydb");
+MongoCollection<Document> collection = database.getCollection("test");
+```
+
+
+## Get A List of Databases
+
+You can get a list of the available databases:
+
+```java
+for (String name: mongoClient.listDatabaseNames()) {
+    System.out.println(name);
+}
+```
+
+Calling the `getDatabase()` on `MongoClient` does not create a database.
+Only when a database is written to will a database be created. Examples
+would be creating an index or collection or inserting a document into a
+collection.
+
+## Drop A Database
+
+You can drop a database by name using a `MongoClient` instance:
+
+```java
+mongoClient.dropDatabase("databaseToBeDropped");
+```
+
+## Create A Collection
+
+Collections in MongoDB are created automatically simply by inserted a document into it. Using the `[createCollection]({{< apiref "com/mongodb/client/MongoDatabase.html#createCollection-java.lang.String-">}})` method, you can also create a collection explicitly in order to to customize its configuration. For example, to create a capped collection sized to 1 megabyte:
+
+```java
+database.createCollection("cappedCollection", new
+CreateCollectionOptions().capped(true).sizeInBytes(0x100000));
+```
+
+## Get A List of Collections
+
+You can get a list of the available collections in a database:
+
+```java
+for (String name : database.listCollectionNames()) {
+    System.out.println(name);
+}
+```
+
+## Drop A Collection
+
+You can drop a collection by using the drop() method:
+
+```java
+collection.dropCollection();
+```
+
+## Create An Index
+
+MongoDB supports secondary indexes. To create an index, you just
+specify the field or combination of fields, and for each field specify the direction of the index for that field.
+For `1` ascending  or `-1` for descending. The following creates an ascending index on the `i` field:
+
+```java
+// create an ascending index on the "i" field
+ collection.createIndex(new Document("i", 1));
+```
+
+## Get a List of Indexes on a Collection
+
+Use the `listIndexes()` method to get a list of indexes on a collection:
+The following lists the indexes on the collection `test`
+
+```java
+for (final Document index : collection.listIndexes()) {
+    System.out.println(index.toJson());
+}
+```
+
+The example should print the following indexes:
+
+```json
+{ "v" : 1, "key" : { "_id" : 1 }, "name" : "_id_", "ns" : "mydb.test" }
+{ "v" : 1, "key" : { "i" : 1 }, "name" : "i_1", "ns" : "mydb.test" }
+```
+
+## Text indexes
+
+MongoDB also provides text indexes to support text search of string
+content. Text indexes can include any field whose value is a string or
+an array of string elements. To create a text index specify the string
+literal "text" in the index document:
+
+```java
+// create a text index on the "content" field
+coll.createIndex(new Document("content", "text"));
+```
+
+As of MongoDB 2.6, text indexes are now integrated into the main query
+language and enabled by default (here we use the [`Filters.text`]({{< apiref "com/mongodb/client/model/Filters.html#text-java.lang.String-">}}) helper):
+
+```java
+// Insert some documents
+collection.insertOne(new Document("_id", 0).append("content", "textual content"));
+collection.insertOne(new Document("_id", 1).append("content", "additional content"));
+collection.insertOne(new Document("_id", 2).append("content", "irrelevant content"));
+
+// Find using the text index
+long matchCount = collection.count(text("textual content -irrelevant"));
+System.out.println("Text search matches: " + matchCount);
+
+// Find using the $language operator
+Bson textSearch = text("textual content -irrelevant", "english");
+matchCount = collection.count(textSearch);
+System.out.println("Text search matches (english): " + matchCount);
+
+// Find the highest scoring match
+Document projection = new Document("score", new Document("$meta", "textScore"));
+Document myDoc = collection.find(textSearch).projection(projection).first();
+System.out.println("Highest scoring document: " + myDoc.toJson());
+```
+
+and it should print:
+
+```json
+Text search matches: 2
+Text search matches (english): 2
+Highest scoring document: { "_id" : 1, "content" : "additional content", "score" : 0.75 }
+```
+
+For more information about text search see the [text index]({{< docsref "/core/index-text" >}}) and
+[$text query operator]({{< docsref "/reference/operator/query/text">}}) documentation.
+
+That concludes the admin quick tour overview!  Remember any [command]({{< docsref "/reference/command">}}) that doesn't have a specific helper can be called by the [database.runCommand()](http://api.mongodb.org/java/3.0/?com/mongodb/async/client/MongoDatabase.html#runCommand-org.bson.conversions.Bson-com.mongodb.ReadPreference-com.mongodb.async.SingleResultCallback-).