Disk README updates

apps/README.md

@@ -11,9 +11,16 @@ Software Archives
 
 PCjs includes archives of selected software:
 
-* IBM PC [Applications](pcx86/) and [Disk Library](/disks/pcx86/)
-* Challenger 1P [Applications](c1p/) and [Disk Library](/disks/c1p/)
-* DEC [PDP-10 Software](pdp10/), [PDP-11 Software](pdp11/), and [Disk Library](/disks/dec/)
+* [IBM PC Application Demos](pcx86/)
+* [Challenger 1P Applications](c1p/)
+* [DEC PDP-10 Tapes and Diagnostics](pdp10/)
+* [DEC PDP-11 Tapes and Diagnostics](pdp11/)
+
+You can also browse our software archives by disk:
+
+* [IBM PC Disk Library](/disks/pcx86/)
+* [Challenger 1P Disk Library](/disks/c1p/)
+* [DEC Disk Library](/disks/dec/)
 
 ---
 

apps/c1p/README.md

@@ -5,7 +5,7 @@ permalink: /apps/c1p/
 ---
 
 Challenger 1P Applications
----
+--------------------------
 
 [C1Pjs](/docs/c1pjs/) runs Challenger 1P (C1P) applications written in:
 

apps/pcx86/README.md

@@ -1,11 +1,11 @@
 ---
 layout: page
-title: IBM PC Application Archive
+title: IBM PC Application Demos
 permalink: /apps/pcx86/
 ---
 
-IBM PC Application Archive
----
+IBM PC Application Demos
+------------------------
 
 Below are selected [PCx86](/docs/about/pcx86/) demos of classic IBM PC applications:
 

disks/README.md

@@ -19,16 +19,21 @@ Additional selected software is available in the PCjs [Software Archives](/apps/
 
 ### PCx86 Disk Image Formats
 
-PCx86 works best with disk images in a **JSON** format, to save conversion time, so that's the only disk image format
-you'll find in the [PCjs Project](https://github.com/jeffpar/pcjs).
+PCx86 works best with disk images in a **JSON** format, to save conversion time, so that's the
+only disk format you'll find in the [PCjs Project](https://github.com/jeffpar/pcjs).
 
-If you're running the PCjs Node web server, you can convert any of our **JSON** disk images into an **IMG** file
-with the [DiskDump API](/api/v1/dump), by setting the *format* parameter set to `img` instead of `json`.  For example:
+There are several ways you can convert a PCjs **JSON** disk image back into a binary **IMG** file:
+
+- Load the desired disk into a PCjs machine and click the **Save** button
+- Use the [DiskDump API](/api/v1/dump) (available only in the [PCjs Node Web Server](/server.js))
+
+When using the [DiskDump API](/api/v1/dump), set the *format* parameter set to `img` instead of `json`.
+For example:
 
 	{{ site.url }}/api/v1/dump?disk=/disks/pcx86/dos/ibm/2.00/PCDOS200-DISK1.json&format=img
 
-As an added bonus, the PCjs Node web server automatically provides "onclick" handlers for all links to JSON-encoded disk
-images, automatically invoking the API for you.
+The [PCjs Node Web Server](/server.js) also generates "onclick" handlers for links to **JSON** disk
+images that automatically invoke the API for you.
 
-See [Creating PCx86-Compatible Disk Images](/docs/pcx86/#creating-pcx86-compatible-disk-images) in the
-[PCx86 Documentation](/docs/pcx86/) for more information about supported disks and formats.
+See [Creating PCx86-Compatible Disk Images](/docs/pcx86/#creating-pcx86-compatible-disk-images)
+in the [PCx86 Documentation](/docs/pcx86/) for more information about supported disks and formats.

disks/c1p/README.md

@@ -1,11 +1,11 @@
 ---
 layout: page
-title: Challenger 1P Disks
+title: Challenger 1P Disk Library
 permalink: /disks/c1p/
 ---
 
-Challenger 1P Disks
----
+Challenger 1P Disk Library
+--------------------------
 
 The project currently includes an [OS-65D Diskette](OS65D33.json), which can be loaded by the
 [OSI Challenger 1P (32Kb) with Disk Support](/devices/c1p/machine/32kb/).

disks/dec/README.md

@@ -1,11 +1,11 @@
 ---
 layout: page
-title: DEC Disk Images
+title: DEC Disk Library
 permalink: /disks/dec/
 ---
 
-DEC Disk Images
----------------
+DEC Disk Library
+----------------
 
 The DEC disk images we have archived are organized by type: 
 

disks/pcx86/README.md

@@ -7,7 +7,7 @@ permalink: /disks/pcx86/
 IBM PC Disk Library
 -------------------
 
-This [Disk Library](/disks/pcx86/library.xml) lists all the [Disk Manifests](#disk-manifests) in the
+Our [IBM PC Disk Library](/disks/pcx86/library.xml) lists all the [Disk Manifests](#disk-manifests) in the
 [PCjs Project](/docs/about/) and makes those disks available to any [IBM PC Machine](/devices/pcx86/machine/)
 in the project that uses the library.  Note that most machines use the *[compiled](/disks/pcx86/compiled/library.xml)*
 form of the library, to reduce machine load time.
@@ -18,10 +18,6 @@ machines that automatically run the software.  Ideally, everything in the librar
 and linked to a page that describes the software in more detail, along with a live demonstration of the software,
 but that's not yet a reality.
 
-For IBM PC application demos, see the [Application Archive](/apps/pcx86/), which focuses exclusively on applications.
-The [Disk Library](/disks/pcx86/library.xml) is a superset, including operating systems, application software,
-computer diagnostics, programming tools, and more.
-
 ### Operating Systems
 
 * [DOS](dos/)
@@ -38,7 +34,18 @@ computer diagnostics, programming tools, and more.
 * [MicroPro WordStar](apps/micropro/wordstar/)
 * [Microsoft Chart](apps/microsoft/chart/)
 * [Microsoft Word](apps/microsoft/word/)
-* [Other...](apps/other/)
+* [More...](apps/other/)
+
+Additional applications for which we have created special "Demo Disks" include:
+
+* [VisiCalc (1981)](/apps/pcx86/1981/visicalc/)
+* [Executive Suite (1982)](/apps/pcx86/1982/esuite/)
+* [RatBas (1982)](/apps/pcx86/1982/ratbas/)
+* [Adventures in Math (1983)](/apps/pcx86/1983/adventmath/)
+* [Rogue (1985)](/apps/pcx86/1985/rogue/)
+* [ThinkTank (1987)](/apps/pcx86/1987/thinktank/)
+* [The Dungeons of Moria (1992)](/apps/pcx86/1992/moria/)
+* [More...](/apps/pcx86/)
 
 ### Games
 
@@ -49,14 +56,14 @@ computer diagnostics, programming tools, and more.
 ### Shareware
 
 * [PC-SIG Library 8th Edition CD-ROM (April 1990)](shareware/pcsig08/)
-* [Other...](shareware/)
+* [More...](shareware/)
 
 ### Tools
 
 * [Borland Tools](tools/borland/)
 * [IBM Tools](tools/ibm/)
 * [Microsoft Tools](tools/microsoft/)
-* [Other Tools](tools/misc/)
+* [More...](tools/misc/)
 
 ### Tests
 

docs/pcx86/README.md

@@ -173,7 +173,7 @@ All of the examples described above are available for [download](examples/).
 
 ### Creating PCx86-Compatible Disk Images
 
-If you have (or find) an IMG disk image file on a server, the PCjs web server provides a
+If you have (or find) an IMG disk image file on a server, the PCjs Node web server provides a
 [DiskDump API](/api/v1/dump) via endpoint "/api/v1/dump" that creates PCx86-compatible disks in JSON:
 
 	{{ site.url }}/api/v1/dump?disk=(file|url)&format=json