diff --git a/docs/storage/driver/factory/factory.go b/docs/storage/driver/factory/factory.go
index e84f0026..a9c04ec5 100644
--- a/docs/storage/driver/factory/factory.go
+++ b/docs/storage/driver/factory/factory.go
@@ -11,7 +11,14 @@ import (
 var driverFactories = make(map[string]StorageDriverFactory)
 
 // StorageDriverFactory is a factory interface for creating storagedriver.StorageDriver interfaces
-// Storage drivers should call Register() with a factory to make the driver available by name
+// Storage drivers should call Register() with a factory to make the driver available by name.
+// Individual StorageDriver implementations generally register with the factory via the Register
+// func (below) in their init() funcs, and as such they should be imported anonymously before use.
+// See below for an example of how to register and get a StorageDriver for S3
+//
+//	import _ "github.com/docker/distribution/registry/storage/driver/s3-aws"
+//	s3Driver, err = factory.Create("s3", storageParams)
+//	// assuming no error, s3Driver is the StorageDriver that communicates with S3 according to storageParams
 type StorageDriverFactory interface {
 	// Create returns a new storagedriver.StorageDriver with the given parameters
 	// Parameters will vary by driver and may be ignored
@@ -21,6 +28,8 @@ type StorageDriverFactory interface {
 
 // Register makes a storage driver available by the provided name.
 // If Register is called twice with the same name or if driver factory is nil, it panics.
+// Additionally, it is not concurrency safe. Most Storage Drivers call this function
+// in their init() functions. See the documentation for StorageDriverFactory for more.
 func Register(name string, factory StorageDriverFactory) {
 	if factory == nil {
 		panic("Must not provide nil StorageDriverFactory")
diff --git a/docs/storage/driver/storagedriver.go b/docs/storage/driver/storagedriver.go
index 2ae9a67e..c27e1031 100644
--- a/docs/storage/driver/storagedriver.go
+++ b/docs/storage/driver/storagedriver.go
@@ -34,7 +34,14 @@ func (version Version) Minor() uint {
 const CurrentVersion Version = "0.1"
 
 // StorageDriver defines methods that a Storage Driver must implement for a
-// filesystem-like key/value object storage.
+// filesystem-like key/value object storage. Storage Drivers are automatically
+// registered via an internal registration mechanism, and generally created
+// via the StorageDriverFactory interface (https://godoc.org/github.com/docker/distribution/registry/storage/driver/factory).
+// See below for an example of how to get a StorageDriver for S3:
+//
+//	import _ "github.com/docker/distribution/registry/storage/driver/s3-aws"
+//	s3Driver, err = factory.Create("s3", storageParams)
+//	// assuming no error, s3Driver is the StorageDriver that communicates with S3 according to storageParams
 type StorageDriver interface {
 	// Name returns the human-readable "name" of the driver, useful in error
 	// messages and logging. By convention, this will just be the registration