diff --git a/README.devel b/README.devel
new file mode 100644
index 0000000..b281843
--- /dev/null
+++ b/README.devel
@@ -0,0 +1,8 @@
+web-assets-devel contains the RPM macros that implement the Fedora Web Assets
+and JavaScript packaging policies.
+
+For more information on packaging Web Assets, see:
+https://fedoraproject.org/wiki/Packaging:Web_Assets
+
+For more information on packaging JavaScript, see:
+https://fedoraproject.org/wiki/Packaging:JavaScript
diff --git a/web-assets.spec b/web-assets.spec
index 9be4952..a64925d 100644
--- a/web-assets.spec
+++ b/web-assets.spec
@@ -14,6 +14,7 @@ URL:            https://fedoraproject.org/wiki/User:Patches/PackagingDrafts/Web_
 Source1:        LICENSE
 Source2:        macros.web-assets
 Source3:        web-assets.conf
+Source4:        README.devel
 
 %description
 %{summary}.
@@ -50,6 +51,7 @@ Requires(postun): systemd
 %prep
 %setup -c -T
 cp %{SOURCE1} LICENSE
+cp %{SOURCE4} README.devel
 
 %build
 #nothing to do
@@ -80,7 +82,7 @@ systemctl reload-or-try-restart httpd.service || :
 
 %files devel
 %{_rpmconfigdir}/macros.d/macros.web-assets
-%doc LICENSE
+%doc LICENSE README.devel
 
 %if 0%{?enable_httpd}
 %files httpd
@@ -91,6 +93,7 @@ systemctl reload-or-try-restart httpd.service || :
 %changelog
 * Sat Aug 24 2013 T.C. Hollingsworth <tchollingsworth@gmail.com> - 4-2
 - tighten dependency on filesystem from other packages
+- add brief README to -devel
 
 * Fri Aug 16 2013 T.C. Hollingsworth <tchollingsworth@gmail.com> - 4-1
 - temporarily disable httpd stuff while we're waiting on sorting out the