docs: Fix value_box() id docstring to use correct full_screen reactive syntax (#2325)

Co-authored-by: Barret Schloerke <barret@posit.co>

Author: karangattu

CHANGELOG.md

@@ -36,6 +36,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 * Fixed rare tabset ID collisions in pages with many navsets. Randomly generated `data-tabsetid` values were drawn from a pool of ~1 million, so a page with dozens of tabsets could occasionally produce two navsets with the same ID (a birthday collision), resulting in duplicate DOM ids and broken tab switching. IDs are now drawn from a pool of 9 trillion. (#2296)
 
+* Fixed the `value_box()` `id` parameter docstring, which previously documented the wrong reactive-value syntax (`input.<id>()["full_screen"]`) for observing the value box's full screen state. It now correctly documents `input.<id>_full_screen()`, matching `card()`. (#2324)
+
 ### Other changes
 
 * Optimized the test suite by avoiding network-based dataset downloads and heavy library imports during Playwright test app startup, reducing setup time significantly. (#2314)

shiny/ui/_card.py

@@ -85,9 +85,9 @@ def card(
     class_
         Additional CSS classes for the returned Tag.
     id
-        Provide a unique identifier for the :func:`~shiny.ui.card` or to report its
-        full screen state to Shiny. For example, using `id="my_card"`, you can observe
-        the card's full screen state with `input.my_card_full_screen()`.
+        A unique identifier for the card. If provided, the card's full screen
+        state is reported to Shiny at `input.<id>_full_screen()` (e.g.,
+        `input.my_card_full_screen()` for `id="my_card"`).
     **kwargs
         HTML attributes on the returned Tag.
 

shiny/ui/_valuebox.py

@@ -370,9 +370,9 @@ def value_box(
         and `text-*` classes (e.g, `"bg-danger"` and `"text-light"`) to customize the
         background/foreground colors.
     id
-        Provide a unique identifier for the :func:`~shiny.ui.value_box()` to report its
-        state to Shiny. For example, using `id="my_value_box"`, you can observe the
-        value box's full screen state with `input.my_value_box()["full_screen"]`.
+        A unique identifier for the value box. If provided, the value box's full
+        screen state is reported to Shiny at `input.<id>_full_screen()` (e.g.,
+        `input.my_value_box_full_screen()` for `id="my_value_box"`).
     **kwargs
         Additional attributes to pass to :func:`~shiny.ui.card`.