Clarify and add details to documents (#1383)

* Update README.md

* Update Menu.md

Thoughts:
- changing the name in display to "Calibrate Tip Offset" (currently shows Calibrate temperature) might be more clear, and then people will not get  nervous and think the number displayed means temperature? since it is just a number, i.e., 765,  and does not say  "765 offset"    I suggest changing to either  "number Offset"   or  changing menu name to "Calibrate Tip Offset"  .  when people incorrectly  beleive the high number is temperature, since it says "calibrate temperature?"  then it leads to unwarranted concern that the pinecil or IronOS is broken.

* Update Menu.md

* Update Temperature.md

clarify language, add punctuation.

* Update HallSensor.md

* Update HallSensor.md

* Update HallSensor.md

* Update HallSensor.md

* Update HallSensor.md

* Update HallSensor.md

* Update HallSensor.md

* Update DebugMenu.md

* Update DebugMenu.md

* Update DebugMenu.md

* Update DebugMenu.md

* Update Flashing.md

* Update HallSensor.md

* Update GettingStarted.md

* Update DebugMenu.md

* Update GettingStarted.md

* Update HallSensor.md

* Update HallSensor.md

* Update HallSensor.md

* Update HallSensor.md

* Update HallSensor.md

* Update Menu.md

* Update Menu.md

* Update Menu.md

* Update Menu.md

* Update Menu.md

* Update Menu.md

* Update Menu.md

* Update Menu.md

* Update Menu.md

* Update Menu.md

* Update Menu.md

* Update Menu.md

* Update Menu.md

* Update Menu.md

* Update Menu.md

* Update Menu.md

* Update Menu.md

* Update Menu.md

* Update Menu.md

* Update Menu.md

* Update Menu.md

* Update Menu.md

* Update Menu.md

* Update Menu.md

* Update Menu.md

* Update Menu.md

* Update History.md

* Update History.md

updated history with some of the Releases that were missing.

* Update DebugMenu.md

* Update DebugMenu.md

* Update DebugMenu.md

* Update DebugMenu.md

* Update DebugMenu.md

* Update DebugMenu.md

* Update DebugMenu.md

* Update README.md

* Update Temperature.md

* Update DebugMenu.md

* Update Flashing.md

* Update Flashing.md

* Update Temperature.md

* Update Temperature.md

* Update DebugMenu.md

* Update DebugMenu.md

* Update Temperature.md

* Update Temperature.md

* Update Temperature.md

* Update Temperature.md

* Update README.md

Co-authored-by: discip <[email protected]>

* Update Temperature.md

* Update Troubleshooting.md

In which troubleshooting conditions/symptoms would:

(1) Re-calibrating  tip offset temperature be appropriate?
(2) Re-Calibrating Input voltage be appropriate?

I think these 2 internal tests would be helpful sections for Troubleshooting, but not sure of all details to write-up.

* Update GettingStarted.md

Co-authored-by: discip <[email protected]>

Documentation/DebugMenu.md

@@ -1,12 +1,11 @@
 # Debugging Menu
 
-In this firmware there is extra debugging information hidden under an extra menu.
-This is accessed by holding the rear (-/B) button on the iron while it is on the home screen.
-
+In this firmware there is extra debugging information in a hidden sub-menu.
 This menu is meant to be simple, so it has no fancy GUI animations.
 
-To move through the menu, use the front (+/A) button.
-To exit, use the rear (-/B) button again.
+- Access by pressing the rear (``-/B``) button on the iron while it is on the home screen.
+- To scroll through the menu, use the front (``+/A``) button.
+- To exit, use the rear (``-/B``) button again.
 
 ## Menu items
 
@@ -63,7 +62,7 @@ This may change during power up as the sources are negotiated in turn.
 
 ### ID
 - This is used by Irons that have an ID and serial number to help check if the iron is authentic. All Pinecil V1 show the same ID number as this is the number programmed into the MCU.
-- The new Pinecil V2 released Aug. 2, 2022 now uses BL706, which enables generating a unique ID/Serial number to every iron. This can be used to verify your Pinecil authenticity [here](https://pinecil.pine64.org/).
+- The new Pinecil V2 released Aug. 2, 2022 now uses BL706, which enables generating a unique ID/Serial number to every iron. This can be used to [verify your V2 authenticity here](https://pinecil.pine64.org/).
 
 ### Max
 
@@ -85,22 +84,22 @@ This indicates the high water mark for the stack for the PID thread. The smaller
 
 ### Hall
 
-This appears if your device is capable of having a magnetic hall effect sensor installed (Pinecil).
-This shows the current field strength reading from the sensor. It can be used to check if the sensor is operational, and measure how strong the magnetic field is for diagnostics and optimal placement of magnets on a stand.
+This appears if your device is capable of having a hall effect sensor installed (Pinecil).
+This shows the current magnetic field strength reading from the sensor. It is used to check if the sensor is operational, and for diagnostics and optimal placement of magnets on a stand (higher number is better/stronger).
 
 # PD Debug menu
 
-On the Pinecil; if the iron is booted up while holding the front button (+); it will show an extra menu for inspecting USB-PD power adapters. Connect to any PD USB power to check Vbus status, even some cell phones with a USB-C port will work if it is PD. It will not show any PD message when Pinecil is powered by DC port, QC, or USB 5V (non-PD).
+On the Pinecil; if the iron is booted up while long holding the front button (`+`); it will show an extra hidden menu for inspecting USB-PD power adapters. We can also connect to any PD USB power to check Vbus status, even some cell phones with a USB-C port will work if it is PD. It will not show PD messages when Pinecil is powered by DC port, QC, or USB 5V (non-PD). For example, if you connect to a QC charger, you may simply see "PD State 6" which indicates "waiting for source" as no PD messages will be ever be sent and you will not be able to use (`+`) to scroll through PD negotiated messages.
 
-The menu navigates like the debug menu, where pressing (+) cycles through elements, and (-) will exit the menu.
+Pressing (`+`) cycles through elements, and (`-`) or unplugging will exit the menu.
 
-The first page shows the PD negotiation stage number; which can be used for diagnosing if PD is not working. Once negotiation is complete; the other screens will show the advertised readings for voltage and current of the proposals.
+The first page shows the PD negotiation stage number; which can be used for diagnosing if PD is not working. Once negotiation is complete; use (`+`) button to advance to other screens which show the different proposals advertised for voltage and current (State 12 means all is good with the PD charger).
 
-##Below is a method for user modification to convert some early models of Pinecil V1 to safely support 24V on the DC5525 barrel.
-Warning (do this at your own risk, read everything in this debug document, and go to the Pine64 chat if you need tips). If you do the cut incorrectly, you could render the Pinecil non-working.
+#### Below is a method for user modification to convert some early models of Pinecil V1 to safely support 24V on the DC5525 barrel.
+⚠️ Warning: do this at your own risk, read everything in this document, and go to the [Pine64 community chat](https://wiki.pine64.org/wiki/Pinecil#Community_links) if you desire advice. An incorrect cut of the trace could render the Pinecil non-working.
 
-A simple user modification to the PCB on some models of V1 allows it to safely use DC24V by cutting a trace line to the Vbus which held it back to 21V. You can check whether your Pinecil V1 needs the update or can benefit from it by using the PD debug menu. After a few seconds or after PD negotiates (state above 5) it will show [No VBus] if the VBus modification is performed correctly or not needed (i.e., late model V1) or it shows [VBus] if the mod has not been done and there is still a connection to the Vbus.
+Background: a simple user modification to the PCB on some models of original V1 allows it to safely use DC24V by cutting a trace line to the Vbus which held it back to 21V. You can check whether your Pinecil V1 needs the update or can benefit from it by using the PD debug menu. After a few seconds or after PD negotiates (state above 5) it will show `[No VBus]` if the VBus modification is performed correctly or not needed (i.e., late model V1). Alternately, if it shows `[VBus]`, then the mod has not been done and there is still a connection to the Vbus (and Vbus connection limits you to 21V).
 
-The mod method is shown in the February 2022 Pine64 community [Updates](https://www.pine64.org/2022/02/15/february-update-chat-with-the-machine/). Early Pinecil V1 models required cutting a trace. Late model V1 made sometime in 2022 came with [No Vbus] already displayed, and no mod required.
+The mod method is shown in the February 2022 [PINE64 community updates](https://www.pine64.org/2022/02/15/february-update-chat-with-the-machine/). Early Pinecil V1 models required cutting a trace. Late model V1 made sometime in 2022 came with '[No Vbus]' already displayed, and no mod is required.
 
-The V2 model released Aug. 2, 2022 is an overhauled PCB with all relevant components capable of 28V. V2 requires no mods to support use of 24V DC Barrel port charger.
+The V2 model released Aug. 2, 2022 is an overhaul of the PCB with all relevant components capable of 28V. V2 requires no mods to support the use of 24V DC Barrel jack charger.

Documentation/Flashing.md

@@ -86,8 +86,12 @@ rmdir /tmp/mntdfu
 Device will reboot and automount will rerun if not disabled.
 Check the extension of your firmware, it should be `.RDY` now.
 
+# Pinecil V2 (Pine64)
+- The MCU in V2 is Bouffalo BL706 and does *not* use usb-dfu for flashing as the previous MCU did.
+- The current firmware (2.18) is very fresh and no upgrade is available/needed.
+- When an update is released for V2, then IronOS will also include an update method to follow.
 
-# Pinecil (Pine64)
+# Pinecil V1 (Pine64)
 
 - The MCU used in Pinecil supports usb-dfu. Reference [Pinecil Wiki](https://wiki.pine64.org/wiki/Pinecil).
 - Recommended Updater: the [Pine64 Updater](https://github.com/pine64/pinecil-firmware-updater/releases), is an easy-to-use GUI app. It is fast and works in several types of OS, i.e. Windows/Mac. It will automatically fetch the newest stable version of IronOS from GitHub.
@@ -101,15 +105,15 @@ Check the extension of your firmware, it should be `.RDY` now.
 
 ### Steps
 
-⛔  Do not use the DC power jack while updating firmware or you may destroy your PC. ⛔
+⛔  Do not use the DC barrel jack while updating firmware or you may destroy your PC. ⛔
 
-1. Download and extract the firmware package from GitHub [IronOS Releases](https://github.com/Ralim/IronOS/releases).
-2. Highly recommend updating `dfu-util` to the newest version.
-3. Enter DFU mode: press and hold (-) button at the back of the iron (do not release).
-4. Connect USB to PC, and USB-C to back of Pinecil, keep holding (-) button down.
-5. The screen will stay **black/off** to indicate the Pinecil is in DFU mode. This is normal.
-6. Once the USB cable is connected at two ends, wait 10 seconds more, then release the (-) button.
-7. Using `dfu-util` you can flash the firmware using a command line like this:
+1. Highly recommend updating `dfu-util` to the newest version before starting.
+2. Download and extract the firmware package from GitHub [IronOS Releases](https://github.com/Ralim/IronOS/releases).
+4. Enter DFU mode: press and hold (`-`) button at the back of the iron before you connect the USB-C cable.
+5. Connect USB to PC, and USB-C to back of Pinecil, keep holding (`-`) button down.
+6. Once the USB cable is connected at two ends, wait ~10 seconds more, then release the (`-`) button.
+7. The screen will stay **black/off** to indicate the Pinecil is in DFU mode. This is normal.
+8. Using `dfu-util` you can flash the firmware using a command line like this:
 
 ```
 dfu-util -D Pinecil_EN.dfu
@@ -167,7 +171,7 @@ Two Options for Windows
 
 ### Steps
 
-⛔  Do not use the DC power jack while updating firmware or you may destroy your PC. ⛔
+⛔  Do not use the DC barrel jack while updating firmware or you may destroy your PC. ⛔
 
 1. Using command line `dfu-util` is similar to above for Linux / Mac.
 2. Highly recommend updating `dfu-util` to the newest version.
@@ -190,7 +194,7 @@ dfu-util -D Pinecil_EN.dfu
 
 ### Steps
 
-⛔  Do not use the DC power jack while updating firmware or you may destroy your PC. ⛔
+⛔  Do not use the DC barrel jack while updating firmware or you may destroy your PC. ⛔
 
 1. If you are uncomfortable with the command line, then this chip vendor supplied GUI tool/drivers is an option.
 2. Download and extract the firmware package from GitHub [IronOS Releases](https://github.com/Ralim/IronOS/releases).
@@ -199,21 +203,21 @@ dfu-util -D Pinecil_EN.dfu
    - GD32 DFU Drivers [here](http://www.gd32mcu.com/en/download?kw=GD32+Dfu+Drivers&lan=en). If the link breaks, search for "GD32 Dfu Drivers" at this [link](http://www.gd32mcu.com/en/download/).
    - Check properties of both downloads, tick Unblock if needed, then Unzip
 4. Install the drivers and the GD32 DFU tool (ignore prompts to update the tool).
-5. Enter DFU mode: press and hold (-) button at the back of Pinecil (do not release).
-6. Connect Pinecil to a PC via USB cable (do not release the (-) yet).
+5. Enter DFU mode: press and hold (`-`) button at the back of Pinecil (do not release).
+6. Connect Pinecil to a PC via USB cable (do not release the (`-`) yet).
 7. Screen will stay **black/off** to indicate the Pinecil is in DFU mode. This is normal.
 8. You may hear a beep from Windows as it connects to Pinecil in DFU mode.
 9. If you see windows notification that it `does not recognize USB device`, then you didn't connect, repeat step 3-8.
 10. Open the GD32 DFU Tool (ignore prompts to update tool).
 11. At the top of the DFU tool, you should see `GD DFU DEVICE 1` appear if you successfully connected Pinecil.
 12. If DFU Device box at top is blank, then Pinecil is not connected in DFU mode, repeat steps 3-11.
-13. If it has been more than 10 seconds since you connected the USB cable, Release the (-) button. (don't use Upload from Device section)
+13. If it has been more than 10 seconds since you connected the USB cable, Release the (`-`) button. (don't use Upload from Device section)
 14. Select `Download to device` > Open > Browse to folder you unzipped in step 2.  
 15. Select the `hex` file for language. English is Pinecil_EN.hex , tick `Verify after download`.
 16. Click `OK` at bottom. After a few minutes you will see 0-100%, Download successfully!  Click `Leave DFU` at the top. 
 17. Disconnect Pinecil cable from PC, plug it into a power supply.
 18. Do not need to press any buttons, a new screen should appear.
-19. To confirm upgrade, hold the minus (-) button down for a few seconds, it then shows new firmware version v2.xx.x....date
+19. To confirm upgrade, hold the minus (`-`) button down for a few seconds, it then shows new firmware version v2.xx.x....date
 
  - If you have errors, see Troubleshooting [above](/Documentation/Flashing.md#troubleshooting).
 

Documentation/GettingStarted.md

@@ -72,16 +72,16 @@ If, after entering sleep mode, the iron still does not see movement for a much l
 The settings menu is the most often evolving aspect of the firmware, so each option is not documented here. However, do not panic, as every menu option has an on-screen description so you don't _need_ to come back here to figure them all out.
 
 To navigate the menu, the two buttons act separately.
-The button that you pressed to enter the menu (rear) scrolls down the options, and the other button (front) will enter and change the current option.
+The rear button (`-/B`) is pressed to enter the menu and scrolls down the main options, and the other front button (`+/A`) will enter and change the current option.
 
-To see a description of an option, just wait and after a little time, it will scroll across the screen.
+To see a description of an option, just wait, and after a few seconds, it will scroll across the screen.
 
-The menu is comprised of a 'main menu' of categories and then sub-items that allows you to adjust parameters.
+The menu is comprised of a 'main menu' of categories and then sub-items that allow you to adjust parameters.
 
 You can long hold buttons to change through options faster, and there is some acceleration when holding the buttons.
 
-There is a small scrollbar that will be shown along the edge of the screen to indicate how far through the current list you are.
+There is a small scrollbar that appears along the right edge of the screen to indicate how far through the current list you are (looks like a dot).
 
-Additionally, this scrollbar will blink rapidly when you are on the last item in a menu choice.
+Additionally, this scrollbar will blink rapidly when you are on the last value in a range of a sub-menu. For example, if you are in Motion Sensitivity, which has a range of 0 - 9,  it will blink when you are at 9.
 
-I highly recommend taking a few minutes to go through all of the options in the menu to get a feel for what you can change, almost every aspect of the internal system is adjustable to suit your needs.
+I highly recommend taking a few minutes to go through all of the options in the menu to get a feel for what you can change, almost every aspect of the internal system is adjustable to suit your needs. If you want to start over, simply go to Advanced settings > Restore factory settings, confirm using the front (`+/A`) button. This sets all menu items to defaults, and keeps the same version firmware.