diff --git a/doc/filesystem.rst b/doc/filesystem.rst
new file mode 100644
index 0000000..fc8a025
--- /dev/null
+++ b/doc/filesystem.rst
@@ -0,0 +1,23 @@
+Bluejay Filesystem
+==================
+
+Filesystem drivers are still a work in progress. To test a file system you will
+want to create and mount a virtual block device. The makefile in ``src/kernel``
+will generate an ``hd0.img`` EXT2 disk image for you automatically. The default
+size is 32 megabytes, but you can create your own of any size if you want. Once
+the image has been created it will be loaded by QEMU automatically.
+
+In order to write to the virtual hard disk from your host operating system you
+should mount it. The ``make mount`` command in ``src/kernel`` mount the image to
+``$(BLUEJAY_ROOT)/mnt``. It will automatically give read and write permissions
+to the current user. This operation uses ``sudo`` internally, you will be
+prompted for your password.
+
+Virtual Filesystem
+------------------
+
+The Bluejay VFS is heavily inspired by UNIX. It relies on inodes and a tree of
+file nodes. The source can be found in ``src/kernel/vfs.c``. This also exports a
+very low-level API for dealing with files -- including the usual read(),
+write(), readdir(), etc -- but this should not be used for much longer. A high
+level API utilizing file descriptors will be implemented to make this simpler.