Updating readme and tweaking method names

Author: aaronpowell

README.md

@@ -8,18 +8,52 @@ This project is a wrapper around the [Cosmos DB](https://docs.microsoft.com/azur
 
 Install via NuGet:
 
-```
+```bash
 dotnet add package FSharp.CosmosDb
 ```
 
 Or using Paket:
 
-```
+```bash
 dotnet paket add FSharp.CosmosDb
 ```
 
 ## Usage
 
+All operations will return an `AsyncSeq` via [FSharp.Control.AsyncSeq](http://fsprojects.github.io/FSharp.Control.AsyncSeq/index.html) that contains the data fetched, data inserted or data updated.
+
+### Insert
+
+```fsharp
+open FSharp.CosmosDb
+
+let connStr = "..."
+
+let insertUsers data =
+    connStr
+    |> Cosmos.fromConnectionString
+    |> Cosmos.database "UserDb"
+    |> Cosmos.container "UserContainer"
+    |> Cosmos.insertMany<User> data
+    |> Cosmos.execAsync
+```
+
+### Update
+
+```fsharp
+open FSharp.CosmosDb
+
+let connStr = "..."
+
+let updateUser id partitionKey =
+    connStr
+    |> Cosmos.fromConnectionString
+    |> Cosmos.database "UserDb"
+    |> Cosmos.container "UserContainer"
+    |> Cosmos.update<User> id partitionKey (fun user -> { user with IsRegistered = true })
+    |> Cosmos.execAsync
+```
+
 ### Query
 
 ```f#
@@ -38,8 +72,6 @@ let findUsers() =
     |> Cosmos.execAsync<User>
 ```
 
-The result from a query is an `AsyncSeq` via [FSharp.Control.AsyncSeq](http://fsprojects.github.io/FSharp.Control.AsyncSeq/index.html).
-
 ```f#
 [<EntryPoint>]
 let main argv =
@@ -52,6 +84,22 @@ let main argv =
     } |> Async.RunSynchronously
 ```
 
+### Delete
+
+```fsharp
+open FSharp.CosmosDb
+
+let connStr = "..."
+
+let updateUser id partitionKey =
+    connStr
+    |> Cosmos.fromConnectionString
+    |> Cosmos.database "UserDb"
+    |> Cosmos.container "UserContainer"
+    |> Cosmos.deleteItem id partitionKey
+    |> Cosmos.execAsync
+```
+
 # FSharp.CosmosDb.Analyzer 💡
 
 [![NuGet Badge - FSharp.CosmosDb](https://buildstats.info/nuget/FSharp.CosmosDb)](https://www.nuget.org/packages/FSharp.CosmosDb)
@@ -73,10 +121,34 @@ Also part of this repo is a [F# Analyzer](https://github.com/ionide/FSharp.Analy
 
 ## Usage
 
-### 1. Set two environment variables:
+### 1. Provide connection information
+
+Connection information can be provided as either environment variables or using an `appsettings.json`/`appsettings.Development.json` file.
+
+#### Environment Variables
+
+The analyzer will look for the following environment variables:
+
+- `FSHARP_COSMOS_CONNSTR` -> A full connection string to Cosmos DB
+- `FSHARP_COSMOS_HOST` & `FSHARP_COSMOS_KEY` -> The URI endpoint and access key
+
+The `FSHARP_COSMOS_CONNSTR` will take precedence if both sets of environment variables are provided
+
+#### App Settings
+
+The analyzer will look for a file matching `appsettings.json` or `appsettings.Development.json` in either the workspace root of the VS Code instance or relative to the file being parsed. The file is expected to have the following JSON structure in it:
+
+```json
+{
+  "CosmosConnection": {
+    "ConnectionString": "",
+    "Host": "",
+    "Key": ""
+  }
+}
+```
 
-- `FSHARP_COSMOS_HOST` -> The host address of your Cosmos DB
-- `FSHARP_COSMOS_KEY` -> The access key of your Cosmos DB
+If `CosmosConnection.ConnectionString` exists, it will be used, otherwise it will use the `CosmosConnection.Host` and `CosmosConnection.Key` to connect.
 
 ### 2. Install the Analyzer from paket
 
@@ -97,7 +169,7 @@ Add the following settings (globally or in the workspace):
 
 [MIT](./License.md)
 
-# Thank Yous
+# Thank You
 
 - Zaid Ajaj for the [Npgsql Analyzer](https://github.com/Zaid-Ajaj/Npgsql.FSharp.Analyzer). Without this I wouldn't have been able to work out how to do it (and there's some code lifted from there)
 - [Krzysztof Cieślak](https://twitter.com/k_cieslak) for the amazing Ionide plugin

samples/FSharp.CosmosDb.Samples/Program.fs

@@ -75,12 +75,12 @@ let getFamilies conn =
 
 let updateFamily conn id pk =
     conn
-    |> Cosmos.updateItem<Family> id pk (fun family -> { family with IsRegistered = not family.IsRegistered })
+    |> Cosmos.update<Family> id pk (fun family -> { family with IsRegistered = not family.IsRegistered })
     |> Cosmos.execAsync
 
 let deleteFamily conn id pk =
     conn
-    |> Cosmos.deleteItem<Family> id pk
+    |> Cosmos.delete<Family> id pk
     |> Cosmos.execAsync
 
 [<EntryPoint>]

src/FSharp.CosmosDb/Cosmos.fs

@@ -72,7 +72,7 @@ module Cosmos =
 
     // --- UPDATE --- //
 
-    let updateItem<'T> id partitionKey (updater: 'T -> 'T) op =
+    let update<'T> id partitionKey (updater: 'T -> 'T) op =
         Update
             { Connection = op
               Id = id
@@ -81,7 +81,7 @@ module Cosmos =
 
     // --- DELETE --- //
 
-    let deleteItem<'T> id partitionKey op =
+    let delete<'T> id partitionKey op =
         Delete
             { Connection = op
               Id = id