diff --git a/README.md b/README.md
index 7a81557..b257e45 100644
--- a/README.md
+++ b/README.md
@@ -5,10 +5,12 @@
 
 ## Synopsis
 
-This is a set of pacman hooks and script that automatically causes snapper to
-perform a pre and post snapshot before and after pacman transactions, similar to
-how YaST does with OpenSuse. This provides a simple way to undo changes to a
-system after a pacman transaction.
+This is a set of [pacman](https://wiki.archlinux.org/index.php/Pacman) hooks and script
+that automatically causes [snapper](http://snapper.io/) to perform a pre and post
+snapshot before and after pacman transactions, similar to how YaST does with OpenSuse.
+This provides a simple way to undo changes to a system after a pacman transaction.
+
+For more information, [see the documentation](https://wesbarnett.github.io/).
 
 ## Installation
 
diff --git a/docs/source/index.rst b/docs/source/index.rst
index b090fc4..0301282 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -62,6 +62,13 @@ need to use a live USB to get into a chroot environment to do any of these thing
 Snapper has a ``snapper rollback`` feature, but your setup has to be properly configured to
 use it. The exact procedure depends on your specific setup. Be careful.
 
+Note that the pre transaction hooks occur before the pacman transaction but after the
+pacman database is synced, if applicable. In other words, if you run `pacman -Syu` and
+roll back the upgrade according to the above instructions, you will not have rolled back
+the pacman database to the previous state. Thus, if, after upgrading and rolling back
+the upgrade, you then install a package, it will possibly be a partial upgrade, which is
+unsupported.
+
 .. toctree::
    :maxdepth: 1