update comments

Author: carl-adams-planet

src/planet_auth/auth.py

@@ -210,9 +210,6 @@ def _is_expired() -> bool:
                 auth_logger.warning(
                     msg=f"Failed to refresh expired credentials (Error: {str(e)}).  Attempting interactive login."
                 )
-                # Fall through to case #4 below.
-                # self.login(allow_open_browser=allow_open_browser, allow_tty_prompt=allow_tty_prompt)
-                # return
 
         # Case #4 above.
         self.login(allow_open_browser=allow_open_browser, allow_tty_prompt=allow_tty_prompt)

src/planet_auth/oidc/request_authenticator.py

@@ -84,7 +84,9 @@ def _refresh(self):
 
     def _refresh_needed(self, check_time: Optional[int] = None) -> bool:
         if self._token_body is None:
-            # Always consider no token in need of a refresh.
+            # Always consider not having the token loaded and primed to be
+            # in need of a refresh.  In _refresh_if_needed(), this will
+            # trigger a reload before doing a network refresh.
             return True
 
         if self._refresh_at is None: