gtkcheckbutton: Document how to keep track of changes for radio buttons

diff --git a/gtk/gtkcheckbutton.c b/gtk/gtkcheckbutton.c
index f0cc8ea6ff51ed3ed18dc1f6ebc5710dd3dda83c..4dec0530ce8773ae980fbba5b97a972db855888e 100644 (file)
--- a/gtk/gtkcheckbutton.c
+++ b/gtk/gtkcheckbutton.c
@@ -77,6 +77,11 @@
  *
  * To add a `GtkCheckButton` to a group, use [method@Gtk.CheckButton.set_group].
  *
+ * When the code must keep track of the state of a group of radio buttons, it
+ * is recommended to keep track of such state through a stateful
+ * `GAction` with a target for each button. Using the `toggled` signals to keep
+ * track of the group changes and state is discouraged.
+ *
  * # CSS nodes
  *
  * ```