diff --git a/filepath.cabal b/filepath.cabal
index 892cb77e2b7bdcff77da2ed58e20c6c517efe22b..7f79ca727360a7f919432d25d9e9b92297059934 100644
--- a/filepath.cabal
+++ b/filepath.cabal
@@ -44,6 +44,10 @@ description:
   .
   "System.OsString" is like "System.OsPath", but more general purpose. Refer to the documentation of
   those modules for more information.
+  .
+  An introduction into the new API can be found in this
+  <https://hasufell.github.io/posts/2022-06-29-fixing-haskell-filepaths.html blog post>.
+  Code examples for the new API can be found <https://github.com/hasufell/filepath-examples here>.
 
 extra-source-files:
   Generate.hs