diff --git a/packages/core/README.md b/packages/core/README.md
index 8d8c00f1..72f9da62 100644
--- a/packages/core/README.md
+++ b/packages/core/README.md
@@ -60,7 +60,7 @@ catch (err) {
 
 #### Logging
 
-Finally, this library provides some utilities for logging:
+Finally, this library provides some utilities for logging. Note that debug logging is hidden from the logs by default. This behavior can be toggled by [setting a secret](https://developer.github.com/actions/managing-workflows/storing-secrets/): `ACTIONS_STEPS_DEBUG = true`.:
 
 ```
 const core = require('@actions/core');