diff --git a/scripts/base/init-bare.zeek b/scripts/base/init-bare.zeek
index 98b16e103e..eaeb9f70ca 100644
--- a/scripts/base/init-bare.zeek
+++ b/scripts/base/init-bare.zeek
@@ -6235,7 +6235,7 @@ export {
 		TIMEOUT,
 		## Connection to backed was lost unexpectedly.
 		CONNECTION_LOST,
-		## Generic operation failed.
+		## Generic operation failure.
 		OPERATION_FAILED,
 		## Key requested was not found in backend.
 		KEY_NOT_FOUND,
@@ -6258,10 +6258,12 @@ export {
 		## One of a set of backend-redefinable return codes.
 		code: ReturnCode;
 		## An optional error string. This should be set when the
-		## ``code`` field is not set ``SUCCESS``.
+		## ``code`` field is not set to ``SUCCESS``.
 		error_str: string &optional;
-		## An optional value returned by ``get`` operations when a match
-		## was found the key requested.
+		## An optional value for operations that can return data. ``get``
+		## operations uses this to return the value when a match was found
+		## for the key requested. ``open_backend`` uses this to return the
+		## backend handle on successful connections.
 		value: any &optional;
 	};
 }
diff --git a/scripts/policy/frameworks/storage/backend/redis/main.zeek b/scripts/policy/frameworks/storage/backend/redis/main.zeek
index 2f037fb769..6a7d3f8b6d 100644
--- a/scripts/policy/frameworks/storage/backend/redis/main.zeek
+++ b/scripts/policy/frameworks/storage/backend/redis/main.zeek
@@ -18,9 +18,9 @@ export {
 		# ``server_host`` field must be unset.
 		server_unix_socket: string &optional;
 
-		# Prefix used in key values stored to differentiate varying types of data
-		# on the same server. Defaults to an empty string, but preferably should
-		# be set to a unique value per Redis backend opened.
+		# Prefix used in keys stored to differentiate varying types of data on the
+		# same server. Defaults to an empty string, but preferably should be set
+		# to a unique value per Redis backend opened.
 		key_prefix: string &default="";
 	};
 }