diff --git a/GB_set_emulate_joypad_bouncing.md b/GB_set_emulate_joypad_bouncing.md
index dde9c4b..16b184e 100644
--- a/GB_set_emulate_joypad_bouncing.md
+++ b/GB_set_emulate_joypad_bouncing.md
@@ -6,8 +6,16 @@ In `joypad.h`
 
 ## Description
 
-TBD
+The physical buttons of various Game Boy models suffer from button bouncing, and do not instantly transition from a released state to a pressed one, and vice versa. This functions controls whether or not this physical behavior should be emulated by software.
+
+By default, button bouncing is emulated.
 
 ## Thread Safety
 
 `GB_set_emulate_joypad_bouncing` is thread-safe and can be called from any thread and context.
+
+## Notes
+
+The time it takes for a bouncing button to stabilize depends on the currently emulated [[model|GB_model_t]]. Super Game Boy and Game Boy Player models never emulate joypad bouncing.
+
+Despite the bouncing pattern being pseudo random, it's completely deterministic and reproducable.
\ No newline at end of file