diff --git a/README.md b/README.md
--- a/README.md
+++ b/README.md
@@ -1,5 +1,7 @@
 ## system-fileio
 
+Please see [deprecation announcement](https://plus.google.com/+MichaelSnoyman/posts/Ft5hnPqpgEx)
+
 This is a small wrapper around the `directory`, `unix`, and `Win32`
 packages, for use with `system-filepath`. It provides a consistent API
 to the various versions of these packages distributed with different
diff --git a/system-fileio.cabal b/system-fileio.cabal
--- a/system-fileio.cabal
+++ b/system-fileio.cabal
@@ -1,5 +1,5 @@
 name: system-fileio
-version: 0.3.16.2
+version: 0.3.16.3
 license: MIT
 license-file: license.txt
 author: John Millikin <jmillikin@gmail.com>
@@ -11,8 +11,8 @@
 homepage: https://github.com/fpco/haskell-filesystem
 bug-reports: https://github.com/fpco/haskell-filesystem/issues
 
-synopsis: Consistent filesystem interaction across GHC versions
-description: Hackage documentation generation is not reliable. For up to date documentation, please see: <http://www.stackage.org/package/system-fileio>.
+synopsis: Consistent filesystem interaction across GHC versions (deprecated)
+description: Please see: https://plus.google.com/+MichaelSnoyman/posts/Ft5hnPqpgEx
 
 extra-source-files:
   README.md