doc updates

Author: carl-adams-planet

src/planet_auth_config_injection/__init__.py

@@ -28,8 +28,9 @@
 
 These concerns belong more to the final end-user application than to a
 library that sits between the Planet Auth library and the end-user
-application, that itself may be used by a variety of applications in
-a variety of deployment environments
+application.  Such libraries themselves may be used by a variety of
+applications in any number of deployment environments, making the
+decision of what configuration to inject a difficult one.
 
 Library writers may provide configuration injection to their developers,
 but should be conscious of the fact that multiple libraries within an

src/planet_auth_config_injection/builtins_provider.py

@@ -18,8 +18,7 @@
 
 # Unlike other environment variables, AUTH_BUILTIN_PROVIDER is not name-spaced.
 # It is intended for libraries and applications to inject configuration by
-# being set within the program.  It's not generally expected to be set by
-# users.
+# being set within the program.  It's not expected to be set by end-users.
 AUTH_BUILTIN_PROVIDER = "PL_AUTH_BUILTIN_CONFIG_PROVIDER"
 """
 Environment variable to specify a python module and class that implement the
@@ -47,11 +46,12 @@ class BuiltinConfigurationProviderInterface(ABC):
 
     def namespace(self) -> str:
         """
-        Application namespace. This will be used as a prefix in various contexts
-        so that multiple applications may use the Planet auth libraries in the same
-        environment without collisions.  Presently, this includes being
-        used as a prefix for environment variables, and as a prefix for config
-        settings store to the user's `~/.planet.json` file.
+        Application namespace. This will be used as a prefix in various
+        contexts so that multiple applications may use the Planet auth
+        libraries in the same environment without collisions.  Presently,
+        this namespace is used as a prefix for environment variables, and
+        as a prefix for config settings store to the user's `~/.planet.json`
+        file.
         """
         return ""
 

src/planet_auth_utils/commands/cli/main.py

@@ -85,7 +85,7 @@ def cmd_plauth_embedded(ctx):
     The embedded command differs from the stand-alone command in that it
     expects the context to be instantiated and options to be handled by
     the parent command.  The [planet_auth.Auth][] library context _must_
-    be set to the object field `AUTH` in the click context object.
+    be saved to the object field `AUTH` in the click context object.
 
     See [planet_auth_utils.PlanetAuthFactory.initialize_auth_client_context][]
     for user-friendly auth client context initialization.