diff --git a/docs/core/platform/developer_credentials.md b/docs/core/platform/developer_credentials.md
index fa90c1de..cfba2c1a 100644
--- a/docs/core/platform/developer_credentials.md
+++ b/docs/core/platform/developer_credentials.md
@@ -29,7 +29,8 @@ async def async_get_authorization_server(
     )
 
 
-# Optional: Only implement if needed to provide a credential from configuration.yaml
+# Optional and provided only for backwards compatibility if integration used to
+# accept YAML credentials. Return YAML client ID and secret.
 async def async_get_developer_credential(
     self, hass: HomeAssistant
 ) -> DeveloperCredential: