diff --git a/docs/README.md b/docs/README.md
index 1dd707fd6..4bbae5053 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -9,7 +9,7 @@ The Yoe distribution includes support for a number of common machines. Notes are
 included for some of them below.
 
 - [Raspberry PI](raspberrypi.md)
-- [BeagleBone -- todo]()
+- [BeagleBone Black](beagleboneblack.md)
 - [ODroid-C2 -- todo]()
 
 ## Using Yoe
diff --git a/docs/beagleboneblack.jpg b/docs/beagleboneblack.jpg
new file mode 100644
index 000000000..a03d361b7
Binary files /dev/null and b/docs/beagleboneblack.jpg differ
diff --git a/docs/beagleboneblack.md b/docs/beagleboneblack.md
new file mode 100644
index 000000000..a2bce35ca
--- /dev/null
+++ b/docs/beagleboneblack.md
@@ -0,0 +1,29 @@
+# Notes on using Yoe on the BeagleBone Black
+
+[up](README.md)
+
+[BSP Layer README](https://github.com/YoeDistro/meta-ti/blob/master/README)
+
+[BeagleBone Black system reference manual](https://github.com/beagleboard/beaglebone-black/wiki/System-Reference-Manual)
+
+## Building/installing an image
+
+1. `git clone git://github.com/YoeDistro/yoe-distro.git`
+1. `cd yoe-distro`
+1. `. beaglebone-envsetup.sh`
+1. `yoe_setup`
+1. `bitbake core-image-base`
+1. insert SD card
+1. `lsblk` (note sd card device, and substitute for /dev/sdX below)
+1. `yoe_install_image /dev/sdX core-image-base`
+1. `sudo eject /dev/sdX`
+1. connect serial console (instructions below)
+1. install SD card in a BeagleBone
+1. hold the boot switch, apply power, and BeagleBone will now boot from SD card
+
+## Connecting to serial console
+
+The BeagleBone Black serial console is available on a 6-pin header as shown in the image
+below. The pinout matches a standard [3.3V FTDI 6-pin connector](https://www.ftdichip.com/Support/Documents/DataSheets/Cables/DS_TTL-232R_CABLES.pdf).
+
+![BeagleBone Serial Console](beagleboneblack.jpg)
diff --git a/docs/raspberrypi.md b/docs/raspberrypi.md
index ac71c6439..ae11d83b8 100644
--- a/docs/raspberrypi.md
+++ b/docs/raspberrypi.md
@@ -4,7 +4,7 @@
 
 [BSP Layer documentation](https://github.com/YoeDistro/meta-raspberrypi/blob/master/docs)
 
-## Building an image
+## Building/installing an image
 
 1. `git clone git://github.com/YoeDistro/yoe-distro.git`
 1. `cd yoe-distro`