diff --git a/CHANGELOG.md b/CHANGELOG.md
index c6eceea2..17491023 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,14 +1,19 @@
 # CHANGELOG
 
+## 1.8.2
+- compatibility: first release to officially support Puppet 5 (previous versions worked unofficially)
+
 ## 1.8.1
 - fix: fix installation of first-ever Brew package on machine (#98)
 
 ## 1.8.0
 - feature: support multi-user environments with new `$multiuser` flag (#89)
 - fix: support for High Sierra
+- compatibility: drop support for Puppet 3
 
 ## 1.7.1
 - fix: include ruby 1.8.3 in metadata.json
+- compatibility: last release to include Puppet 3 support
 
 ## 1.7.0
 - feature: allow usage within non-brew and bundler environments
diff --git a/metadata.json b/metadata.json
index 32dc7bb2..1c4ed292 100644
--- a/metadata.json
+++ b/metadata.json
@@ -1,6 +1,6 @@
 {
   "name": "thekevjames-homebrew",
-  "version": "1.8.1",
+  "version": "1.8.2",
   "author": "thekevjames",
   "summary": "Homebrew (+brewcask! +taps!) package installer and provider",
   "license": "Apache-2.0",