Update README.md

Change-Id: Ida894f7be64613ee5f87804c17e3594178bd9156

Author: skriptble

README.md

@@ -1,11 +1,19 @@
-# mongo-go-driver
+<p align="center"><img src="etc/assets/mongo-gopher.png" width="250"></p>
+<p align="center">
+  <a href="https://goreportcard.com/report/github.com/mongodb/mongo-go-driver"><img src="https://goreportcard.com/badge/github.com/mongodb/mongo-go-driver"></a>
+  <a href="https://godoc.org/github.com/mongodb/mongo-go-driver/mongo"><img src="etc/assets/godoc-mongo-blue.svg" alt="GoDoc"></a>
+  <a href="https://godoc.org/github.com/mongodb/mongo-go-driver/bson"><img src="etc/assets/godoc-bson-blue.svg" alt="GoDoc"></a>
+  <a href="https://docs.mongodb.com/ecosystem/drivers/go.html"><img src="etc/assets/docs-mongodb-green.svg"></a>
+</p>
 
-MongoDB Driver for Go.
-[![GoDoc](https://godoc.org/github.com/mongodb/mongo-go-driver/mongo?status.svg)](https://godoc.org/github.com/mongodb/mongo-go-driver/mongo)
+# MongoDB Go Driver
+
+The MongoDB supported driver for Go.
 
 -------------------------
 - [Requirements](#requirements)
 - [Installation](#installation)
+- [Usage](#usage)
 - [Bugs/Feature Reporting](#bugs-feature-reporting)
 - [Testing / Development](#testing--development)
 - [Continuous Integration](#continuous-integration)
@@ -14,7 +22,7 @@ MongoDB Driver for Go.
 -------------------------
 ## Requirements
 
-- Go 1.9 or higher. We aim to support the latest supported versions go.
+- Go 1.10 or higher. We aim to support the latest supported versions of go.
 - MongoDB 3.2 and higher.
 
 -------------------------
@@ -26,6 +34,88 @@ The recommended way to get started using the MongoDB Go driver is by using `dep`
 dep ensure -add github.com/mongodb/mongo-go-driver/mongo
 ```
 
+-------------------------
+## Usage
+
+To get started with the driver, import the `mongo` package, create a `mongo.Client`:
+
+```go
+import "github.com/mongodb/mongo-go-driver/mongo"
+
+client, err := mongo.NewClient("mongodb://localhost:27017")
+```
+
+And connect it to your running MongoDB server:
+
+```go
+ctx, _ := context.WithTimeout(context.Background(), 10*time.Second)
+err = client.Connect(ctx)
+```
+
+To do this in a single step, you can use the `Connect` function:
+
+```go
+ctx, _ := context.WithTimeout(context.Background(), 10*time.Second)
+client, err := mongo.Connect(ctx, "mongodb://localhost:27017")
+```
+
+Calling `Connect` does not block for server discovery. If you wish to know if a MongoDB server has been found and connected to,
+use the `Ping` method:
+
+```go
+ctx, _ = context.WithTimeout(context.Background(), 2*time.Second)
+err = client.Ping(ctx, readpref.Primary())
+```
+
+To insert a document into a collection, first retrieve a `Database` and then `Collection` instance from the `Client`:
+
+```go
+collection := client.Database("testing").Collection("numbers")
+```
+
+The `Collection` instance can then be used to insert documents:
+
+```go
+ctx, _ = context.WithTimeout(context.Background(), 5*time.Second)
+res, err := collection.InsertOne(ctx, bson.M{"name": "pi", "value": 3.14159})
+id := res.InsertedID
+```
+
+Several query methods return a cursor, which can be used like this:
+
+```go
+ctx, _ = context.WithTimeout(context.Background(), 30*time.Second)
+cur, err := collection.Find(ctx, nil)
+if err != nil { log.Fatal(err) }
+defer cur.Close(ctx)
+for cur.Next(ctx) {
+   var result bson.M
+   err := cur.Decode(&result)
+   if err != nil { log.Fatal(err) }
+   // do something with result....
+}
+if err := cur.Err(); err != nil {
+  log.Fatal(err)
+}
+```
+
+For methods that return a single item, a `SingleResult` instance is returned:
+
+```go
+var result struct {
+    Value float64
+}
+filter := bson.M{"name": "pi"}
+ctx, _ = context.WithTimeout(context.Background(), 5*time.Second)
+err = collection.FindOne(ctx, filter).Decode(&result)
+if err != nil {
+    log.Fatal(err)
+}
+// Do something with result...
+```
+
+Additional examples and documentation can be found under the examples directory and [on the MongoDB Documentation website](https://docs.mongodb.com/ecosystem/drivers/go.html).
+
 -------------------------
 ## Bugs / Feature Reporting