diff --git a/.gitignore b/.gitignore
index 180693a..b651a3d 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,4 +1,5 @@
-SOURCES/d3-flame-graph-4.0.7.tar.gz
-SOURCES/js-d3-flame-graph-vendor-4.0.7-1.tar.xz
-/d3-flame-graph-4.0.7.tar.gz
-/js-d3-flame-graph-vendor-4.0.7-1.tar.xz
+/d3-flame-graph-*.tar.gz
+/js-d3-flame-graph-vendor-*.tar.xz
+/js-d3-flame-graph-vendor-*.tar.xz.manifest
+/d3-flame-graph*/
+*.rpm
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..97df79c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,26 @@
+# js-d3-flame-graph
+The js-d3-flame-graph package
+
+## Upgrade instructions
+* update `Version`, `Release`, `%changelog` and tarball NVRs in the specfile
+* create bundles and manifest: `make clean all`
+* update specfile with contents of the `.manifest` file
+* run local build: `rpkg local`
+* run rpm linter: `rpkg lint -r js-d3-flame-graph.rpmlintrc`
+* run a scratch build: `fedpkg scratch-build --srpm`
+* upload new source tarballs: `fedpkg new-sources *.tar.gz *.tar.xz`
+* commit new `sources` file
+
+## Backporting
+* create the patch
+* declare and apply (`%prep`) the patch in the specfile
+* if the patch affects Node.js dependencies
+  * create new tarballs
+  * update the specfile with new tarball path and contents of the `.manifest` file
+
+Note: the Makefile automatically applies patches before creating the tarballs
+
+## Patches
+* `*.patch`: regular patches applied to the source, applied in the Makefile before vendoring and in the specfile (e.g. updating dependencies)
+* `*.vendor.patch`: patches applied to the vendor tarball (e.g. patching vendored sources before generating a webpack)
+* `*.cond.patch`: conditionally applied patches in the specfile
diff --git a/js-d3-flame-graph.rpmlintrc b/js-d3-flame-graph.rpmlintrc
new file mode 100644
index 0000000..fa44ec4
--- /dev/null
+++ b/js-d3-flame-graph.rpmlintrc
@@ -0,0 +1,2 @@
+addFilter("W: strange-permission list_bundled_nodejs_packages.py 755")
+addFilter("W: patch-not-applied .+.vendor.patch")
diff --git a/list_bundled_nodejs_packages.py b/list_bundled_nodejs_packages.py
old mode 100755
new mode 100644