SDL: Clarify the expected usage of SDL_StorageReady()

From ac5fca4ae5711daea231dd70c0acb506ab1da513 Mon Sep 17 00:00:00 2001
From: Sam Lantinga <[EMAIL REDACTED]>
Date: Tue, 25 Feb 2025 08:56:23 -0800
Subject: [PATCH] Clarify the expected usage of SDL_StorageReady()

Fixes https://github.com/libsdl-org/SDL/issues/12201
---
 include/SDL3/SDL_storage.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/include/SDL3/SDL_storage.h b/include/SDL3/SDL_storage.h
index d3599b9327f2c..870b737bb011b 100644
--- a/include/SDL3/SDL_storage.h
+++ b/include/SDL3/SDL_storage.h
@@ -450,7 +450,7 @@ extern SDL_DECLSPEC bool SDLCALL SDL_CloseStorage(SDL_Storage *storage);
  *
  * This function should be called in regular intervals until it returns true -
  * however, it is not recommended to spinwait on this call, as the backend may
- * depend on a synchronous message loop.
+ * depend on a synchronous message loop. You might instead poll this in your game's main loop while processing events and drawing a loading screen.
  *
  * \param storage a storage container to query.
  * \returns true if the container is ready, false otherwise.