docs: Reformat the menu-item.md

docs/api/menu-item.md

@@ -2,7 +2,7 @@
 
 > Add items to native application menus and context menus.
 
-See [`menu`](menu.md) for examples.
+See [`Menu`](menu.md) for examples.
 
 ## Class: MenuItem
 
@@ -12,11 +12,11 @@ Create a new `MenuItem` with the following method:
 
 * `options` Object
   * `click` Function - Will be called with
-     `click(menuItem, browserWindow, event)` when the menu item is clicked
+    `click(menuItem, browserWindow, event)` when the menu item is clicked.
-  * `role` String - Define the action of the menu item; when specified the
+  * `role` String - Define the action of the menu item, when specified the
-     `click` property will be ignored
+    `click` property will be ignored.
   * `type` String - Can be `normal`, `separator`, `submenu`, `checkbox` or
-     `radio`
+    `radio`.
   * `label` String
   * `sublabel` String
   * `accelerator` [Accelerator](accelerator.md)
@@ -69,19 +69,29 @@ On macOS `role` can also have following additional values:
 When specifying `role` on macOS, `label` and `accelerator` are the only options
 that will affect the MenuItem. All other options will be ignored.
 
-## Instance Properties
+### Instance Properties
 
-The following properties (and no others) can be updated on an existing `MenuItem`:
+The following properties are available on instances of `MenuItem`:
 
-  * `enabled` Boolean
+#### `menuItem.enabled`
-  * `visible` Boolean
-  * `checked` Boolean
 
-Their meanings are as described above.
+A Boolean indicating whether the item is enabled, this property can be
+dynamically changed.
 
-A `checkbox` menu item will toggle its `checked` property on and off when
+#### `menuItem.visible`
-selected. You can add a `click` function to do additional work.
+
+A Boolean indicating whether the item is visible, this property can be
+dynamically changed.
+
+#### `menuItem.checked`
+
+A Boolean indicating whether the item is checked, this property can be
+dynamically changed.
+
+A `checkbox` menu item will toggle the `checked` property on and off when
+selected.
 
 A `radio` menu item will turn on its `checked` property when clicked, and
-will turn off that property for all adjacent items in the same menu. Again,
+will turn off that property for all adjacent items in the same menu.
-you can add a `click` function for additional behavior.
+
+You can add a `click` function for additional behavior.

docs/api/session.md

@@ -566,3 +566,4 @@ app.on('ready', function () {
       console.error('Failed to register protocol')
   })
 })
+```