Update application-menu.md

simonhamp · web-flow · commit ce8ec9b01d6f · 2024-12-19T20:12:05.000Z
diff --git a/resources/views/docs/1/the-basics/application-menu.md b/resources/views/docs/1/the-basics/application-menu.md
@@ -229,9 +229,6 @@ been pressed at the time the item was clicked.
 
 ### Hotkeys
 
-When a menu item is fired from a key combo press, the event's `$combo` parameter will have its `triggeredByAccelerator`
-equal to `true`.
-
 Hotkeys can be defined for all menu items, either via their relevant `Menu` facade method or by using the `hotkey()`
 chainable method:
 
@@ -249,6 +246,9 @@ You can find a list of available hotkey modifiers in the
 Unlike global hotkeys, hotkeys registered to menu items will only be fired when one of your application's windows are
 focused or the relevant context menu is open.
 
+When a menu item is fired from a hotkey combo press, the event's `$combo` parameter will have its `triggeredByAccelerator`
+value set to `true`.
+
 ### Label items
 
 The simplest menu item is just a label. You may use the `Menu::label()` method to add a label item to your menu:
@@ -259,15 +259,15 @@ Menu::make(
 );
 ```
 
-These are great if you just want your app to do something in response to the user clicking the menu item or pressing
+These are great if when you want your app to do something in response to the user clicking the menu item or pressing
 the hotkey combo.
 
 ### Link items
 
-Link items allow you to define navigational elements within your menu. These can either navigate users to another URL
+Link items allow you to define navigational elements within your menus. These can either navigate users to another URL
 within your application or to an external page hosted on the internet.
 
-You may add a link to your menu by using the `Menu::link()` method.
+You may add a link to your menu by using the `Menu::link()` method:
 
 ```php
 Menu::link('/login', 'Login');
@@ -295,20 +295,21 @@ may introduce serious vulnerabilities onto your user's device.**
 
 ### Checkbox and Radio items
 
-In some cases, your app may not require a preferences panel, and a few interactive menu items will suffice to allow
-your user to configure some settings. Or you may wish to make certain commonly-used setting more accessible.
+In some cases, your app may not require a preferences panel, and a few interactive menu items may suffice to allow
+your user to configure some settings. Or you may wish to make certain commonly-used settings more readily accessible.
 
 Checkbox and Radio items enable you to create menu items for just these purposes. They operate in a very similar way
-to checkboxes and radio buttons in a web view.
+to checkboxes and radio buttons in a web form.
 
 You may use the `Menu::checkbox()` and `Menu::radio()` methods to create such items, passing the initial state of the
-item to the `checked` parameter:
+item to the `checked` parameter (the default state is 'unchecked'):
 
 ```php
-Menu::checkbox('Word wrap', checked: false);
+Menu::checkbox('Word wrap', checked: true);
 ```
 
-When Checkbox and Radio items are triggered, the event data will indicate whether or not the item is currently checked.
+When Checkbox and Radio items are triggered, the click event data will indicate whether or not the item is currently
+checked via the `$item['checked']` value.
 
 #### Radio groups
 
@@ -334,15 +335,15 @@ These two radio groups will operate independently of each other.
 
 NativePHP also ships with a number of "special" menu items that provide specific behavior for you to use in your menus.
 
-These items usually have default labels and hotkeys associated with them and provide the basic default functionality
+These items usually have default labels and hotkeys associated with them and provide the basic, default functionality
 commonly associated with them in any web browser. Therefore, they do not fire any click events.
 
-You may only override their label.
+You may only override their labels.
 
 ### Separators
 You may add separators to your menu by using the `Menu::separator()` method.
 
-A separator is a horizontal line that separates menu items.
+A separator is a horizontal line that visually separates menu items.
 
 ```php
 Menu::make(
@@ -352,9 +353,12 @@ Menu::make(
 );
 ```
 
+As already noted, they also aid in logically grouping radio items.
+
 ### Undo and Redo
-If you have chosen not to include the [default Edit menu](#the-edit-menu) to your application menu,
-you may add undo and redo functionality to your app by using the `Menu::undo()` and `Menu::redo()` methods.
+If you have chosen not to include the [default Edit menu](#the-edit-menu) in your application menu,
+you may add the default undo and redo functionality to your app by using the `Menu::undo()` and
+`Menu::redo()` methods.
 
 ```php
 Menu::make()
@@ -368,9 +372,9 @@ but for more complex undo/redo workflows, you may wish to implement your own log
 these items.**
 
 ### Cut, Copy, and Paste
-If you have chosen not to include the [default Edit menu](#the-edit-menu) to your application menu,
-you may add cut, copy and paste functionality to your app by using the `Menu::cut()`, `Menu::copy()` and `Menu::paste()`
-methods.
+If you have chosen not to include the [default Edit menu](#the-edit-menu) in your application menu,
+you may add the default cut, copy and paste functionality to your app by using the `Menu::cut()`, `Menu::copy()` and
+`Menu::paste()` methods.
 
 ```php
 Menu::make()
@@ -392,7 +396,7 @@ if your currently-focused window is [fullscreen-able](/docs/the-basics/windows#f
 
 ```php
 Menu::make()
-    Menu::fullscreen('Go full screen'),
+    Menu::fullscreen('Supersize me!'),
 );
 ```
 
