doc: prepare script for v2

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,18 +121,24 @@
 > 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
+> install the LiBCM firmware to the board. So long as LiBCM is
+> connected to your computer via its black USB cable, linked 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 should succeed, unless something has gone seriously
+> wrong with LiBCM.
 
 ## Future