doc: fix: rephrase closeout

README.md

@@ -39,13 +39,26 @@
 > this version of the IDE was released in Dec 2021 and will likely not
 > see another version bump.
 
-> Click *Install* > *Authenticate*. Once it is done installing, click
-> Open. You will be notified that without access to the `dialout`
-> group, your user will not be able to control serial devices in order
-> to flash Arduino boards, and will give you some instructions for how
-> to change that permission, including a reboot step. I am going to
-> ignore that for now, but you should take time to follow those steps
-> at this point.
+> Click *Install* > *Authenticate*. First-time installation will take
+> a minute -- it is finished when the "Install" button turns into the
+> "Open" button.
+
+> Once it is done installing, click Open. You will be notified that
+> without access to the `dialout` group, your user will not be able to
+> control serial devices in order to flash Arduino boards, and will
+> give you some instructions for how to change that permission,
+> including a reboot step.
+
+> I am going to ignore that for now, but you should take time to
+> follow those steps at this point. If you do not, you will probably
+> have trouble interacting with the Arduino board at the heart of
+> LiBCM.
+
+### Transition
+
+> Next, I am going to show you how to follow the same steps on
+> Fedora. Ubuntu users should feel free to skip a few minutes ahead to
+> see the LiBCM code-download compilation process.
 
 ## Installing the Arduino IDE: Fedora
 
@@ -59,9 +72,10 @@
 
 (Open terminal and show this)
 
-> ... You will encounter a similar prompt as with the Ubuntu
-> installation process, instructing you on how you can add your user
-> to the dialout secondary group. Do so.
+> If you watched the Ubuntu install steps, you will encounter a
+> similar prompt as you did on the Ubuntu installation process,
+> instructing you on how you can add your user to the dialout
+> secondary group. Do so.
 
 ## Bonus: Compilation
 
@@ -73,7 +87,7 @@
 > instructions for use by the general public. However, since this
 > video was made in response to difficulties by LiBCM users to use
 > Linux to install LiBCM firmware updates, I am also going to show you
-> how to compile and update LiBCM.
+> how to compile (but not update) LiBCM.
 
 > To download the code, go to
 > https://github.com/doppelhub/Honda_Insight_LiBCM. This URL is
@@ -107,25 +121,35 @@
 > select "Arduino Mega or Mega 2560".
 
 > Finally, to test compilation, hit the check-mark in the
-> top-left. As compilation proceeds, you may see warnings in the
-> output, but you can tell whether the compilation succeeded by
-> checking whether the compiler reports the ultimate size of the
-> sketch's program storage space and dynamic memory:
+> top-left.
+
+(Resize console window)
+
+> As compilation proceeds, you may see warnings in the output, but you
+> can tell whether the compilation succeeded by checking whether the
+> compiler reports the ultimate size of the sketch's program storage
+> space and dynamic memory:
 
 > "Sketch uses 40062 bytes (15%) of program storage space" ...
 
-> ... and so on. At this point, so long as LiBCM is connected to your
-> computer via its black USB cable, connected to the Arduino IDE in
-> the Tools > Ports option, and as long as your system user is allowed
-> to use `dialout` group resources, firmware installation will
-> succeed, unless something has gone seriously wrong with LiBCM.
+> ... and so on. Once you reach this point, you are well-prepared to
+> connect to LiBCM and upload firmware to it -- you will do this using
+> the arrow Upload arrow to the right of the compile (a.k.a. Verify)
+> checkmark. So long as LiBCM is connected to your computer via its
+> black USB cable, linked to the Arduino IDE in the Tools > Ports
+> option (using the right baud rate), and as long as your system user
+> is allowed to use `dialout` group resources, firmware installation
+> should succeed, unless something has gone seriously wrong with
+> LiBCM.
 
-## Future
+## Future Video?
 
-> If there's demand for it, I may make a short video showing some of
-> the things that may go wrong while connecting to LiBCM using a Linux
-> machine. Linux provides a lot of easily-accessible interfaces to
-> hardware that make it easy to tell how the computer is interacting
-> with USB devices, and over the years I've found it really helpful to
-> bisect issues down to hardware or software ones.
+> If there's demand for it, I may make a short video showing the
+> actual LiBCM firmware update process on Linux. In that video, I
+> would also show you how you can use Linux to navigate some of the
+> issues you may encounter while trying to update LiBCM. Unlike other
+> operating systems, Linux provides easily-accessible interfaces to
+> hardware, making it easier to tell how the computer is interacting
+> with USB devices. Over the years, I've found Linux to be really
+> helpful to bisect issues down to hardware or software ones.
 

TODO.md

@@ -0,0 +1,7 @@
+# Before next re-recoding
+
+- Review linsight.org firmware install materials
+
+- Maybe:
+  - Show hardware install process
+  - Mention Arduino Serial Monitor - Baud rate?