README tweaks

Author: inexorabletash

README.md

@@ -1,13 +1,6 @@
 # A CHIP-8 interpreter for Apple II / ProDOS-8
 
-CHIP-8 is a fantasy video game console definition from the 1970s by Joseph Weisbecker.
-
-References:
-
-* https://en.wikipedia.org/wiki/CHIP-8
-* https://github.com/mattmikolay/chip-8/
-* https://tobiasvl.github.io/blog/write-a-chip-8-emulator/
-* https://github.com/Timendus/chip8-test-suite
+[CHIP-8](https://en.wikipedia.org/wiki/CHIP-8) is a fantasy video game console definition from the 1970s by Joseph Weisbecker.
 
 This version runs on Apple II models that support Double Low Resolution graphics (DGR):
 
@@ -20,15 +13,28 @@ This version runs on Apple II models that support Double Low Resolution graphics
 * Clones such as the Laser 128, Franklin ACE 2200, Franklin ACE 500
 * Emulators such as MAME, Virtual ][, AppleWin, etc.
 
-It runs in ProDOS-8 and follows the "interpreter protocol" so that launchers such as Bitsy Bye and Apple II DeskTop can automatically launch CHIP-8 programs with it, when appropriately configured.
+It runs in ProDOS-8 and follows the "interpreter protocol" so that launchers such as [Bitsy Bye](https://prodos8.com/bitsy-bye/) and [Apple II DeskTop](https://a2desktop.com) can automatically launch CHIP-8 programs with it.
 
 # For Users
 
-If distributed on a disk with [ProDOS-8 2.4](https://prodos8.com/) and the file is named `BASIS.SYSTEM` then files selected in [Bitsy Bye](https://prodos8.com/bitsy-bye/) will launch with the interpreter automatically.
+To run a CHIP-8 program, copy the file to a [ProDOS-8 2.4](https://prodos8.com/) with the `CHIP8.SYSTEM` renamed to (or copied as) `BASIS.SYSTEM`, then boot the disk. [Bitsy Bye](https://prodos8.com/bitsy-bye/) will run. Pick the CHIP-8 file and it will run automatically.
 
 > TIP: [Apple II DeskTop](https://a2desktop.com) will use a copy of `BASIS.SYSTEM` in the same directory to launch unknown file types.
 
-* Press <kbd>Esc</kbd> at any time to return to ProDOS.
+## CHIP-8 Programs
+
+There are many online archives of CHIP-8 programs:
+
+* https://johnearnest.github.io/chip8Archive/?sort=platform#chip8
+* https://chip-8.github.io/links/
+* https://github.com/kripod/chip8-roms
+* https://www.zophar.net/pdroms/chip8/chip-8-games-pack.html
+
+> NOTE: Only CHIP-8 games are supported, not SUPER-CHIP or XO-CHIP.
+
+## Controls
+
+* Press <kbd>Esc</kbd> at any time to quit to ProDOS.
 * Press <kbd>9</kbd> and <kbd>0</kbd> to change border colors.
 * Press <kbd>[</kbd> and <kbd>]</kbd> to change background colors.
 * Press <kbd>,</kbd> and <kbd>.</kbd> to change foreground colors.
@@ -52,13 +58,9 @@ Use these keys on a QWERTY keyboard instead:
 |<kbd>A</kbd>|<kbd>S</kbd>|<kbd>D</kbd>|<kbd>F</kbd>|
 |<kbd>Z</kbd>|<kbd>X</kbd>|<kbd>C</kbd>|<kbd>V</kbd>|
 
-## CHIP-8 Programs
-
-* https://johnearnest.github.io/chip8Archive/?sort=platform#chip8
-
-> Note that only CHIP-8 ("chip8") games are supported, not SUPER-CHIP ("schip") or XO-CHIP ("xochip").
+> TIP: CHIP-8 programs use a variety of key combinations. Look for documentation where you found the program, or mash the keys to figure out the controls. Have fun!
 
-CHIP-8 programs can be copied to a ProDOS disk and launched using Bitsy Bye, as long as `CHIP8.SYSTEM` has been placed on the disk and renamed `BASIS.SYSTEM`.
+### Compatibility & Quirks
 
 Some CHIP-8 programs require different compatibility settings. This can be enabled by changing the ProDOS file type of the program to `$5D` (`ENT` or Entertainment), and setting the aux type to `$C800` (for "CHIP-8") with the lower byte used as "quirks" flags as follows:
 
@@ -87,6 +89,12 @@ For detailed "quirks" definitions, see https://github.com/Timendus/chip8-test-su
 
 # For Developers
 
+## Development References
+
+* https://tobiasvl.github.io/blog/write-a-chip-8-emulator/
+* https://github.com/Timendus/chip8-test-suite
+* https://chip-8.github.io/
+
 ## Building
 
 Fetch, build, and install [cc65](http://cc65.github.io/cc65/) (in a separate directory):