diff --git a/BUGS b/BUGS
new file mode 100644
index 0000000..7a97f2c
--- /dev/null
+++ b/BUGS
@@ -0,0 +1,12 @@
+
+- No documentation on how to set up a dbfs filesystem.
+
+- Updating the middle of a file will cause data corruption (creating
+  from scratch, or appending, should work fine)
+
+- Directories are read and written in their entirety, which is nice
+  for small directories but punishingly slow for large directories.
+
+- Long term, we only want to store metadata in DB, not file data as
+  well.
+
diff --git a/Makefile.am b/Makefile.am
index 5aaf74b..fe0b395 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -22,5 +22,5 @@
 dbdebugfs_SOURCES = dbdebugfs.c
 dbdebugfs_LDADD	= @GLIB_LIBS@ @DB_LIBS@ libdbfs.a
 
-EXTRA_DIST	= autogen.sh SCHEMA
+EXTRA_DIST	= autogen.sh SCHEMA BUGS
 
diff --git a/NEWS b/NEWS
index 5972a52..fc6dcdb 100644
--- a/NEWS
+++ b/NEWS
@@ -1,7 +1,7 @@
 
 Version 0.8 -- under development
 
-- 
+-
 
 Version 0.7 -- March 19, 2007
 
diff --git a/README b/README
index e7d1890..d0ca170 100644
--- a/README
+++ b/README
@@ -6,9 +6,20 @@
 Software home:
 http://www.kernel.org/pub/linux/kernel/people/jgarzik/fs/
 
+git repository:
+git://git.kernel.org/pub/scm/fs/fuse/dbfs.git
+
 Build (and probably runtime) dependencies:
 * GLib 2.x
 * DB 4.x
 * FUSE
 * OpenSSL, or compatible libcrypto (for SHA1)
 
+Other documentation to read:
+AUTHORS		List of primary program authors
+BUGS		List of problems we need to fix
+COPYING		Software license (GPL)
+INSTALL		Generic GNU autotools software installation instructions
+NEWS		Overview of per-release changes
+SCHEMA		Database data structure layout
+