Documentation updates

devices/pc/keyboard/README.md

@@ -1,12 +1,41 @@
 ---
 layout: page
-title: 8042 Keyboard Controller Internals
+title: IBM PC Keyboard Devices
 permalink: /devices/pc/keyboard/
 ---
 
-8042 Keyboard Controller Internals
+IBM PC Keyboard Devices
 ---
 
+### Keyboard Configuration Files
+
+The easiest way for a machine to include a *[Keyboard](/docs/pcjs/keyboard/)* component in its XML configuration file
+is to reference one of the project's keyboard configuration files, using the *ref* attribute; eg:
+
+	<keyboard ref="/devices/pc/keyboard/us83-buttons-minimal.xml"/>
+
+The referenced XML file automatically defines the keyboard's hardware characteristics (eg, model) and
+any visual elements, such as buttons to simulate common keystrokes, or even complete "soft keyboard" layouts. 
+
+Here's what *us83-buttons-minimal.xml* currently looks like:
+
+	<keyboard id="keyboard" model="us83" pos="left" padleft="8px" padbottom="8px">
+	    <control type="button" binding="esc">ESC</control>
+	    <control type="button" binding="f1">F1</control>
+	    <control type="button" binding="f10">F10</control>
+	</keyboard>
+
+The following IBM keyboard configuration files are currently available:
+
+ - [us83-buttons-arrows.xml](us83-buttons-arrows.xml)
+ - [us83-buttons-functions.xml](us83-buttons-functions.xml)
+ - [us83-buttons-minimal.xml](us83-buttons-minimal.xml)
+ - [us83-buttons-softkeys.xml](us83-buttons-softkeys.xml)
+ - [us84-buttons-arrows.xml](us84-buttons-arrows.xml)
+ - [us84-buttons-functions.xml](us84-buttons-functions.xml)
+
+### 8042 Keyboard Controller Internals
+
 The following documents were obtained from [halicery.com](http://halicery.com/):
 
 - [8042_INTERN.TXT](8042_INTERN.TXT)