From eecfce9e459161e5f793d08187f24adcfc07c8be Mon Sep 17 00:00:00 2001 From: Jeff Parsons Date: Fri, 17 Apr 2020 12:48:03 -0700 Subject: [PATCH] Updated library page --- documents/index.md | 33 +++++++++++++++++++++++++++++++-- 1 file changed, 31 insertions(+), 2 deletions(-) diff --git a/documents/index.md b/documents/index.md index c86b0ccee..35545d651 100644 --- a/documents/index.md +++ b/documents/index.md @@ -1,13 +1,42 @@ --- layout: page -title: PCjs Documents +title: PCjs Library permalink: /documents/ redirect_from: - /docs/ - /pubs/pc/ + - /pubs/ --- -Use the {% include explorer/link.html %} to browse the entire collection of PCjs Documents. +The PCjs Library is nothing more than an assortment of documentation collected for the various hardware and software +featured on the website. Much of it was obtained from [bitsavers.org](http://bitsavers.org/), with significant amounts +of PC hardware documentation from [minuszerodegrees.net](http://minuszerodegrees.net/) and PC software documentation +from [os2museum.com](http://www.os2museum.com/wp/). + +Unfortunately, we've not done a good of consistently recording where a given document (or piece of software) came from. +Going forward, we plan to be more thorough. In the documentation display below, you'll now see that many documents include +a link to the original "[Source]". There's no guarantee that that source is definitive, or the best available, or even +still in existence; it's simply where we happened to find our copy. + +Over the years, we've also acquired our own physical copies of software and documentation from ebay and generous PCjs users, +which we scan and post as well. In those cases, no source link is displayed; internally, the source is recorded as "PCjs" +or "pcjs.org". For example, we scanned the complete collection of [PC Tech Journal](/documents/magazines/pctj/) magazines; +someone else has since downloaded and uploaded that collection to [archive.org](https://archive.org/details/pctechjournal), +but for our records, the source is still PCjs. + +## Organization + +Each piece of documentation is filed under one of three general areas: Hardware, Software, or Documents. The idea is to +have a single page for a given machine and its manuals, or for a given piece of software and its manuals. Anything else (ie, +any document not created by the manufacturer of a piece of hardware or software featured here) is filed under an appropriate +category within Documents. + +There are a few gray areas. For example, there are programming books that also come with software, and in a few cases, we +have archived a copy of that software here. So such a book *could* be filed with the software, rather than with other +programming books. However, since such software is supplemental, we generally file such a book *primarily* as a document, +and include references to it from other pages as appropriate. + +Use the {% include explorer/link.html %} to browse the collection. Someday we may add a built-in Search feature as well. We'll see. {% include gallery/alldocs.html title="All Hardware Documents" root="hardware" %}