   This function accepts the following options:
 
     * `:user` - (string) the OrientDB user. This option is **required**.
-    * `:pass` - (string) the OrientDB password. This option is **required**.
-    * `:connection` - specifies the connection type. To connect to the OrientDB
-      server (to perform server operations) this option must have the value
-      `:server`; to connect to a database, this option must have the value
-      `{:db, db_name, db_type}`.
-    * `:host` - (string) the host where the OrientDB server is running. Defaults
-      to `"localhost"`.
-    * `:port` - (integer) the port where the OrientDB server is
-      running. Defaults to `2424`.
+    * `:password` - (string) the OrientDB password. This option is **required**.
+    * `:connection` - specifies the connection type. This option is
+      **required**. To learn more about the connection type, refer to the docs
+      for the `MarcoPolo` module (there's a "Connection type" section). It can
+      be:
+      * `:server` - connects to the server to perform server operations
+      * `{:db, db_name, db_type}` - connects to a database to perform database
+        operations. `db_type` can be either `:document` or `:graph`.
+    * `:host` - (string or charlist) the host where the OrientDB server is
+      running. Defaults to `"localhost"`.
+    * `:port` - (integer) the port where the OrientDB server is running.
+      Defaults to `2424`.
+
+  ## Examples
+
+  Connecting to the server:
+
+      iex> {:ok, conn} = MarcoPolo.start_link user: "admin", password: "admin", connection: :server
+      iex> is_pid(conn)
+      true
+
+  Connecting to a database:
+
+      iex> connection = {:db, "MyDatabase", :document}
+      iex> {:ok, conn} = MarcoPolo.start_link user: "admin", password: "admin", connection: connection
+      iex> is_pid(conn)
+      true
 
   """
   @spec start_link(Keyword.t) :: GenServer.on_start

      without waiting for a response. This performs a *fire and forget*
      operation, returning `:ok` every time.

  ## Examples

      iex> rid = %MarcoPolo.RID{cluster_id: 1, position: 10}

    * `:no_response` - if `true`, send the request to the OrientDB server
      without waiting for a response. This performs a *fire and forget*
      operation, returning `:ok` every time.

  This operation can only be performed on connections to a database. To learn
  more about the connection type, look at the "Connection type" section in the
  docs for the `MarcoPolo` module.

  ## Examples

