diff --git a/BREAKING_CHANGES b/BREAKING_CHANGES
new file mode 100644
index 00000000..631bb1bf
--- /dev/null
+++ b/BREAKING_CHANGES
@@ -0,0 +1,3 @@
+- buffer.URL and buffer.URI are now instances of nsIURI rather than strings.
+  The former string representation may be obtained via the spec property.
+  See https://developer.mozilla.org/en/nsIURI for more details.