diff --git a/docs/index.md b/docs/index.md
index b7449db..4b0fe44 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,6 +1,6 @@
 # Glide: Vendor Package Management for Go
 
-Glide is a package manager for [Go](https://golang.org) that is conceptually similar to package managers for other languages such as Cargo for Rust, NPM for Node.js, Pip for Python, Bundler for Ruby, and so forth.
+[Glide](https://glide.sh) is a package manager for [Go](https://golang.org) that is conceptually similar to package managers for other languages such as Cargo for Rust, NPM for Node.js, Pip for Python, Bundler for Ruby, and so forth.
 
 Glide provides the following functionality:
 
diff --git a/docs/resolving-imports.md b/docs/resolving-imports.md
new file mode 100644
index 0000000..c48e9e8
--- /dev/null
+++ b/docs/resolving-imports.md
@@ -0,0 +1,37 @@
+# Resolving Imports
+
+Glide scans an applications codebase to discover the projects to manage in the `vendor/` directory. This happens in a few different ways. Knowing how this works can help you understand what Glide is doing.
+
+## At Initialization
+
+When you run `glide create` or `glide init` to create a `glide.yaml` file for a codebase Glide will scan your codebase to identify the imports. It does this by walking the filesystem to identify packages. In each package it reads the imports within the Go files.
+
+From this it will attempt to figure out the external packages. External packages are grouped by the root version control system repo with their sub-packages listed underneath. Figuring out the root version control repo compared with the packages underneath it follows the same rules for the `go` tool.
+
+1. GitHub, Bitbucket, Launchpad, IBM Jazz, and go.googlesource.com are evaluated with special rules. We know or can talk to an API to learn about these repos.
+2. If the package associated with the repo ends in `.git`, `.hg`, `.bzr`, or `.svn` this is used to determine the root and the type of version control system.
+3. If the rules don't provide an answer a `go get` request occurs to try and lookup the information.
+
+Again, this is the same way `go` trying to determine an external location when you use `go get`.
+
+If the project has dependency configuration stored in a Godep, GPM, or GB file that information will be used to populate the version within the `glide.yaml` file.
+
+## At Update
+
+When `glide update`, `glide up`, `glide get`, or `glide install` (when no `glide.lock` is present) Glide will attempt to discover the complete dependency tree. That is all dependencies including dependencies of dependencies of dependencies.
+
+### The Default Option
+
+The default method is to walk the referenced import tree. The resolver starts by scanning the local application to get a list of imports. Then it looks at the specific package imports, scans the imported package for imports, and repeats the lookup cycle until the complete tree has been fetched.
+
+That means that only imports referenced in the source are fetched.
+
+When a version control repo is fetched it does fetch the complete repo. But, it doesn't scan all the packages in the repo for dependencies. Instead, only the packages referenced in the tree are scanned with the imports being followed.
+
+Along the way configuration stored in Glide, Godep, GPM, and GB files are used to work out the version to set and fetched repos to. The first version found while walking the import tree wins.
+
+### All Possible Dependencies
+
+Using the `--all-dependencies` flag on `glide update` will change the behavior of the scan. Instead of walking the import tree it walks the filesystem and fetches all possible packages referenced everywhere. This downloads all packages in the tree. Even those not referenced in an applications source or in support of the applications imports.
+
+As in other cases, Glide, Godep, GPM, and GB files are used to set the version of the fetched repo.
diff --git a/mkdocs.yml b/mkdocs.yml
index 3a0150d..29109e0 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -6,6 +6,7 @@
 - Versions and Ranges: versions.md
 - Lock file: glide.lock.md
 - Commands: commands.md
+- Resolving Imports: resolving-imports.md
 - Vendor Directories: vendor.md
 - F.A.Q.: faq.md
 theme: readthedocs