lsusb in a terminal and you should see a line similar to this:
+Insert the USB plug of the cable into a USB port on the machine that you will use to monitor the Pinebook Pro’s serial console, ensuring that the audio jack of the serial cable is be fully inserted into the Pinebook Pro’s headphone port. Run <code>lsusb</code> in a terminal and you should see a line similar to this:
- Bus 001 Device 058: ID 1a86:7523 QinHeng Electronics HL-340 USB-Serial adapter
+ Bus 001 Device 058: ID 1a86:7523 QinHeng Electronics HL-340 USB-Serial adapter
Serial console output should now be accessible on the respective machine using a terminal emulator, such as screen, picocom or minicom. Here are a few examples of how to invoke a terminal emuator:
* `screen /dev/ttyUSB0 1500000`
* `picocom /dev/ttyUSB0 -b 1500000`
-* `minicom -D /dev/ttyUSB0 -b 1500000`
\ No newline at end of file
+* `minicom -D /dev/ttyUSB0 -b 1500000`
diff --git a/content/documentation/Pinecil/Checklist.adoc b/content/documentation/Pinecil/Checklist.adoc
deleted file mode 100644
index 1a302381..00000000
--- a/content/documentation/Pinecil/Checklist.adoc
+++ /dev/null
@@ -1,54 +0,0 @@
----
-title: "Checklist"
-draft: false
-menu:
- docs:
- title:
- parent: "Pinecil"
- identifier: "Pinecil/Checklist"
- weight:
----
-
-Prep tasks:
-
-. *Clean new cartridges/tips with 99% isopropyl alcohol (IPA)* to remove factory residue before installing (avoid strange behavior from poor electric contact). If you have none, try to at least wipe down the new cartridge with a clean towel especially the 2 contacts at the rear white end (do not use water, as it could get into the small white seam line).
-. Do not bend the two tiny https://pine64.com/product/pinecil-copper-clips/[internal contacts], they are thin spring metal and may break.
-. Only use one port, USB-C or the DC barrel, but Never both at the same time. Damage will occur to PC/Laptop/Pinecil!
-. If using a DC barrel brick for power, do not use more than 24V for Pinecil V2 and not more than 21V for Pinecil V1 (a link:/documentation/Pinecil/How_to_repair/#pinecil_v1_24v_mod[special end-user modification] is possible for V1 which allows it to use up to 24V safely).
-
-Upon receipt, or buying a used Pinecil, one may want to check the following:
-
-. The display turns on when 5-21V is supplied (V2 models can do 24V).
-* Use a USB type C cable or a DC 5525 _center positive_ barrel https://www.youtube.com/watch?v=5DBTNplNTfA[(how to check polarity)]
-* Use the video linked to make sure the DC barrel charger is _Center Positive_ before plugging it into Pinecil. Several users have accidentally plugged incorrect center-negative chargers into Pinecil which immediately breaks it because it is the wrong type of charger (this is sometimes repairable, see link:/documentation/#_community_and_support[live community chat]).
-* Note that 5v shows _DC low_ and is not high enough to run Pinecil. 5V is only enough for firmware update and to see the menu.
-. It gets full power.
-* 20V from a 20V capable USB-C PD charger or power from DC barrel charger that is the appropriate specifications. The screen displays the voltage from the charger.
-* Check both orientations of the USB-C cable (try to flip it if one way doesn't work).
-. Check for new firmware updates, see the firmware section.
-* Note: do not connect the DC barrel at the same time as a USB-C cable. Pinecil was designed to only have one cable plugged in at a time. You could damage/break the PC and Pinecil doing this.
-* V1 and V2 used different flasher apps to load firmware onto the Pinecil, see the link:/documentation/Pinecil/Firmware/[Firmware section].
-* Updating firmware requires a _data_ capable USB cable connected to a PC/laptop.
-. Check that both buttons work
-* `[-]` to enter menu or decrease temperature, long press `[-]` to get the software version info or to turn off heating
-* `[+]` to turn on heating or select a menu item
-. The displayed text rotates according to gravity when orientation is set to _Automatic_
-* User interface -> Display orientation -> Automatic
-* https://ralim.github.io/IronOS/Settings/[More menu options listed on IronOS documents]
-. Check that all 3 external screws are present
-.. One near the back of the screen (ground screw for optional ground wire)
-.. One at the front on top (to hold the tip in)
-.. One at the front on the bottom (to hold the case together, does not touch the tip)
-. Check that the tip is clean & wipe it down with a dry towel or IPA (uniformly silver at the front, with no pitting or texture).
-* Some tips come pre-dipped in solder for protection and may look odd. Heat them up then wipe clean on a soldering sponge or brass wool and inspect.
-* Heat up the tips a few times to 350°C for a couple minutes to check that they are working and melting solder.
-* See link:/documentation/Pinecil/Tips/[Pinecil Tips] and link:/documentation/Pinecil/Guides_to_soldering/[Guides to Soldering & Maintenance] for soldering advice.
-* Re-tin the tip before storing is advised to prevent oxidation.
-. Check that it heats up with an installed tip, and stops increasing when it reaches the set point.
-* This may draw up to ~3A, make sure the link:/documentation/Pinecil/Power_supplies/Power_supplies[power supply] can provide a minimum of 3amps or more.
-* Minor overshoot may occur, but, disconnect power if the temperature keeps going up higher without user input and check with the link:/documentation/#_community_and_support[live volunteer Pinecil channel].
-. Do a simple test is to see if the iron will melt solder at approximately the expected temperature for the alloy of solder being tested.
-* If no direct measurement is possible, set it to ~230°C and see if it just about melts SAC (lead-free) solder (~190°C for leaded). This may be more if the room is cold.
-. If there are multiple tips, wipe all of them with isopropyl alcohol (IPA) or a dry clean towel and check that they all heat up.
-. If the tip moves a little while using it, try to hold Pinecil with the screen facing the side or screen downwards. Members found that if the screen is up and the screw loosens during use, then the tip wobbles a little. Changing holding angles helps the tip press against the solid barrel instead of wobbling on the stub of the small screw.
-
diff --git a/content/documentation/Pinecil/Checklist.md b/content/documentation/Pinecil/Checklist.md
new file mode 100644
index 00000000..3c4599fa
--- /dev/null
+++ b/content/documentation/Pinecil/Checklist.md
@@ -0,0 +1,53 @@
+---
+title: "Checklist"
+draft: false
+menu:
+ docs:
+ title:
+ parent: "Pinecil"
+ identifier: "Pinecil/Checklist"
+ weight:
+---
+
+Prep tasks:
+
+1. **Clean new cartridges/tips with 99% isopropyl alcohol (IPA)** to remove factory residue before installing (avoid strange behavior from poor electric contact). If you have none, try to at least wipe down the new cartridge with a clean towel especially the 2 contacts at the rear white end (do not use water, as it could get into the small white seam line).
+2. Do not bend the two tiny [internal contacts](https://pine64.com/product/pinecil-copper-clips/), they are thin spring metal and may break.
+3. Only use one port, USB-C or the DC barrel, but Never both at the same time. Damage will occur to PC/Laptop/Pinecil!
+4. If using a DC barrel brick for power, do not use more than 24V for Pinecil V2 and not more than 21V for Pinecil V1 (a [special end-user modification](/documentation/Pinecil/How_to_repair/#pinecil_v1_24v_mod) is possible for V1 which allows it to use up to 24V safely).
+
+Upon receipt, or buying a used Pinecil, one may want to check the following:
+
+1. The display turns on when 5-21V is supplied (V2 models can do 24V).
+ * Use a USB type C cable or a DC 5525 _center positive_ barrel [(how to check polarity)](https://www.youtube.com/watch?v=5DBTNplNTfA)
+ * Use the video linked to make sure the DC barrel charger is _Center Positive_ before plugging it into Pinecil. Several users have accidentally plugged incorrect center-negative chargers into Pinecil which immediately breaks it because it is the wrong type of charger (this is sometimes repairable, see [live community chat](/documentation/#_community_and_support)).
+ * Note that 5v shows _DC low_ and is not high enough to run Pinecil. 5V is only enough for firmware update and to see the menu.
+2. It gets full power.
+ * 20V from a 20V capable USB-C PD charger or power from DC barrel charger that is the appropriate specifications. The screen displays the voltage from the charger.
+ * Check both orientations of the USB-C cable (try to flip it if one way doesn’t work).
+3. Check for new firmware updates, see the firmware section.
+ * Note: do not connect the DC barrel at the same time as a USB-C cable. Pinecil was designed to only have one cable plugged in at a time. You could damage/break the PC and Pinecil doing this.
+ * V1 and V2 used different flasher apps to load firmware onto the Pinecil, see the [Firmware section](/documentation/Pinecil/Firmware/).
+ * Updating firmware requires a _data_ capable USB cable connected to a PC/laptop.
+4. Check that both buttons work
+ * `[-]` to enter menu or decrease temperature, long press `[-]` to get the software version info or to turn off heating
+ * `[+]` to turn on heating or select a menu item
+5. The displayed text rotates according to gravity when orientation is set to _Automatic_
+ * User interface -> Display orientation -> Automatic
+ * [More menu options listed on IronOS documents](https://ralim.github.io/IronOS/Settings/)
+6. Check that all 3 external screws are present
+ 1. One near the back of the screen (ground screw for optional ground wire)
+ 2. One at the front on top (to hold the tip in)
+ 3. One at the front on the bottom (to hold the case together, does not touch the tip)
+7. Check that the tip is clean & wipe it down with a dry towel or IPA (uniformly silver at the front, with no pitting or texture).
+ * Some tips come pre-dipped in solder for protection and may look odd. Heat them up then wipe clean on a soldering sponge or brass wool and inspect.
+ * Heat up the tips a few times to 350°C for a couple minutes to check that they are working and melting solder.
+ * See [Pinecil Tips](/documentation/Pinecil/Tips/) and [Guides to Soldering & Maintenance](/documentation/Pinecil/Guides_to_soldering/) for soldering advice.
+ * Re-tin the tip before storing is advised to prevent oxidation.
+8. Check that it heats up with an installed tip, and stops increasing when it reaches the set point.
+ * This may draw up to ~3A, make sure the [power supply](/documentation/Pinecil/Power_supplies/Power_supplies) can provide a minimum of 3amps or more.
+ * Minor overshoot may occur, but, disconnect power if the temperature keeps going up higher without user input and check with the [live volunteer Pinecil channel](/documentation/#_community_and_support).
+9. Do a simple test is to see if the iron will melt solder at approximately the expected temperature for the alloy of solder being tested.
+ * If no direct measurement is possible, set it to ~230°C and see if it just about melts SAC (lead-free) solder (~190°C for leaded). This may be more if the room is cold.
+10. If there are multiple tips, wipe all of them with isopropyl alcohol (IPA) or a dry clean towel and check that they all heat up.
+11. If the tip moves a little while using it, try to hold Pinecil with the screen facing the side or screen downwards. Members found that if the screen is up and the screw loosens during use, then the tip wobbles a little. Changing holding angles helps the tip press against the solid barrel instead of wobbling on the stub of the small screw.
diff --git a/content/documentation/Pinecil/Firmware.adoc b/content/documentation/Pinecil/Firmware.adoc
deleted file mode 100644
index 57f1894a..00000000
--- a/content/documentation/Pinecil/Firmware.adoc
+++ /dev/null
@@ -1,205 +0,0 @@
----
-title: "Firmware"
-draft: false
-menu:
- docs:
- title:
- parent: "Pinecil"
- identifier: "Pinecil/Firmware"
- weight:
----
-
-This article is about updating/flashing the link:/documentation/Pinecil[Pinecil] firmware.
-
-== Overview
-
-TIP: Pinecil is designed to use *only 1 power port* at any time. Only the USB-C cable should be plugged in during firmware updates. Never attempt to use both rear ports at the same time or the PC and Pinecil will be damaged.
-
-{{< figure src="/documentation/images/Pinecil-V1andV2.png" title="right" width="400" >}}
-
-The firmware that comes with the Pinecil is https://ralim.github.io/IronOS/[open source Ralim's IronOS]. It's a good idea to check for updates regularly as development is very active and there may be enhancements or bug fixes.
-
-Depending on whether you have a Pinecil V1 or V2, they are updated using different flashers since they have completely different MCU chip (brains). The V1 is any Pinecil sold up to July 2022 (has a blue thumb grip). The V2 is any Pinecil sold after Aug 1, 2022 (has a green thumb grip). If you don't have the two models mentioned, then you might not have an link:/documentation/Pinecil/Authenticity[authentic Pinecil]. This aritcle is designed and tested on authentic Pinecils only.
-
-* Go to the appropriate section below depending on if you have a V1 or V2 model.
-* Long hold down `[-]` to see the current firmware version installed.
-* It is very hard to brick a Pinecil doing a firmware update because of the firmware is in ROM. Usually, just re-flashing it fixes it. Even if the other firmware caused the screen to go black, one could connect, put the Pinecil into flash mode, and flash again to an older or newer version of firmware or a beta version.
-* Pinecil V1 only uses *.hex files for both firmware and boot logo art.
-* Pinecil V2 uses only *.bin files for firmware.
-
-NOTE: Loading boot logo art onto the V2 (BL706 MCU chip) is not yet possible. Volunteers are looking into this on both GitHub Blisp and GitHub IronOS. If you would like to see the progress or help with the code see https://github.com/Ralim/IronOS/issues/1373#issuecomment-1414925011[Boot Logo Art ticket]
-
-== Flash Mode
-
-IMPORTANT: Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.
-
-Both V1 and V2 connect to the PC/laptop and enter the Flash mode the same way for updating purposes:
-
-. Plug one end of the USB cable to the PC/laptop.
-. Long hold the `[-]` button _before plugging_ the USB-C cable into the back of the Pinecil. Keep holding down the `[-]` for ~10-15 seconds after plugging in the cable, then release the button.
-. Screen should be black/empty which means Pinecil is in Flashing Mode. If you have issues, try again, do not plug the USB-C cable into Pinecil until you first press & hold the `[-]` button. Flip the cable over or try another port/cable/PC if you still have issues.
-. Unlike irons from other brands, Pinecil will *not* show in the PC as a USB data drive. On Windows, you will hear a single beep when connected in flash mode.
-. Then use one of the flasher methods below based on the OS you have in order to flash new firmware (link:/documentation/Pinecil/Firmware/#update_v1[older V1 instructions are lower down here]).
-
-== Update V2: Windows
-
-IMPORTANT: Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.
-
-=== Option 1: PineFlash
-
-The PineFlash is a GUI updater it's an all-in one app that downloads firmware and flashes.
-
-. Download the easy premade binary installer for Windows https://github.com/Spagett1/PineFlash[here].
-. If PineFlash doesn't work try the Blisp terminal app.
-
-=== Option 2: Blisp
-
-. Blisp is a CLI (command line interface or terminal) and needs a program like the Powershell, which is already installed on most Windows PCs. For using Blisp only a couple basic terminal commands are needed, such as `cd` to change directories (folders).
-. If you prefer to use "command" terminal over Powershell, see instructions for Command in link:/documentation/Pinecil/Firmware/#troubleshoot_v2_flashing[Troubleshooting and then skip to #8 here]
-. Can install newest Powershell https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows?view=powershell-7.3[from here].
-. Rick click and run Powershell as administrator.
-. Enter this command `C:\> Set-ExecutionPolicy RemoteSigned` to enable powershell permissions. It only needs to be done one time and should persist on reboots.
-. Check that Powershell has correct permissions,enter `Get-ExecutionPolicy -list`
-. LocalMachine should be RemoteSigned.
-. For V2, download the https://github.com/pine64/blisp#how-to-update-pinecil-v2[Blisp Flasher here].
-. Next download the newest firmware, https://github.com/Ralim/IronOS/releases/[release here]. Scroll down to the bottom of the page, under Assets, get the Pinecilv2.zip.
-. Right click on all zip files > properties, and check "Unblock" if present to unblock them, then extract the Blisp zip and the Pinecilv2 zip https://github.com/builder555/PineSAM/discussions/106#discussion-4960445[screenshot of Unblock here]. If you don't see "Unblock" then keep going.
-. From the Pinecilv2 folder you extracted above, copy the `Pinecilv2_EN.bin` (English) file into the Blisp folder (same place as the Blisp.exe). Other languages are available, substitute the `Pinecil_EN.bin` file for the language file desired (follow 2-letter international language code). The Pinecil Zip can now be deleted, only the single BIN file in the language you want is used.
-. Run powershell as administrator.
-. Now, connect the Pinecil V2 to the PC: hold down the [-] *Before* plugging the cable to the back of Pinecil. See (link:/documentation/Pinecil/Firmware/#flash_mode[Flash Mode section for details]).
-. Screen on Pinecil should be black/empty before proceeding; it means you are in the correct Flash mode. If you are curious, it will connect as a PORT COM device in Device Manager. If your screen is not black, then repeat the connect to PC above. If necessary, change cables or ports, or try a different PC/laptop.
-. Use `cd` to change to the Blisp folder (location of blisp.exe and Pinecil_EN.bin).
-.. `#example change to location of blisp folder`
-.. `PS C:\> cd G:\Users\name\Downloads\blisp\`
-. Execute this line (can replace the *EN* file name with the language bin selected).
-.. Type the `.\` (dot and slash) or it will fail to find the files!
-.. `.\blisp.exe write -c bl70x --reset .\Pinecilv2_EN.bin`
-. After update, unplug and reboot it, then hold down `[-]` for ~3 seconds to see the new version.
-. See link:/documentation/Pinecil/Firmware/#troubleshoot_v2_flashing[troubleshooting] down below if it does not flash.
-
-== Bluetooth (BLE) Apps
-
-* Must have newer Pinecil V2 model (green thumb grip).
-* First, update firmware to *Ralim's IronOS 2.21* or higher. 2.21 is the first stable release that has BLE support built-in for Pinecil V2.
-* Get the https://github.com/builder555/PineSAM[PineSAM app here] or try https://joric.github.io/pinecil/[Joric's BLE website here]. These BLE apps are also listed in link:/documentation/Pinecil/Development_projects[Development projects]
-* https://joric.github.io/pinecil/[Joric's BLE API] may be the easiest to get started with as it does not require anything to be installed. It runs off Chromium based browsers (since they are capable of BLE GATT) and shows a graph of Temperature/Watts (MacOS/iPhone and firefox don't work bc they do not have BLE GATT). Hint: some Chromium browsers like Vivaldi, may need to check `chrome://flags/` and enable bluetooth options.
-* https://github.com/builder555/PineSAM[PineSAM] is BLE Settings and Menus and will run on any major OS. It allows change of all settings, and can be controlled from Mac, Linux, Windows, iPhone, Android and more; needs python script running as back end. For easy phone connection just open a browser address `\http://++{{$type}}
+{{ .Inner | markdownify }}
+