diff --git a/config/config.go b/config/config.go
index ad93e3a..2e7bc27 100644
--- a/config/config.go
+++ b/config/config.go
@@ -54,13 +54,15 @@ type Config interface {
 	// not a boolean, it will return fallback.
 	GetBool (key string, fallback bool) (bool, error)
 	// Set sets a value in the user-level config file. If the key is
-	// invalid, it returns ErrMalformedKey. Note that *will* cause a write
-	// to disk, and a read from disk for whatever is watching the user file.
+	// invalid, it returns ErrMalformedKey. Note that calling this behavior
+	// *will* cause a write to disk, and a read from disk for whatever is
+	// watching the user file.
 	Set (key string, value Value) error
 	// Reset removes the value from the user-level config file, resetting it
 	// to what is described by the system-level config files. If the key is
-	// invalid, it returns ErrMalformedKey. Note that *will* cause a write
-	// to disk, and a read from disk for whatever is watching the user file.
+	// invalid, it returns ErrMalformedKey. Note that calling this behavior
+	// *will* cause a write to disk if successful , and a read from disk for
+	// whatever is watching the user file.
 	Reset (key string) error
 	// OnChange specifies a function to be called whenever a value is
 	// changed. The callback is always run within the backend's event loop