diff --git a/docs/src/changelog/in_the_style_of_gravityfalls__espresso_machine_S1601100496_St50_G7.5(1).png b/docs/src/changelog/in_the_style_of_gravityfalls__espresso_machine_S1601100496_St50_G7.5(1).png
deleted file mode 100644
index 03e686754b..0000000000
Binary files a/docs/src/changelog/in_the_style_of_gravityfalls__espresso_machine_S1601100496_St50_G7.5(1).png and /dev/null differ
diff --git a/docs/src/changelog/v0.16.md b/docs/src/changelog/v0.16.md
index d16fcb456d..34cf06d473 100644
--- a/docs/src/changelog/v0.16.md
+++ b/docs/src/changelog/v0.16.md
@@ -1 +1,19 @@
-# v0.16
+# v0.16 - Pandoras Box
+
+![](./v0.16/banner.png)
+
+Switched to a [custom pflag fork](https://github.com/rsteube/carapace-pflag) with adaptions for non-posix variants like long shorthands (e.g. `-shorthand`).
+
+> So far this has been done by patching `os.Args` which was rather hacky.
+Modifications to the flag parser are quite complex though, so there might be some issues.
+
+see [#1293](https://github.com/rsteube/carapace-bin/pull/1293/files)
+
+[Spec](https://github.com/rsteube/carapace-spec) files support non-posix flags now as well:
+
+```yaml
+flags:
+  -np: non-posix shorthand
+  -np, -nonposix:  non-posix shorthand and longhand
+  -np, --nonposix: non-posix shorthand mixed with posix longhand
+```
\ No newline at end of file
diff --git a/docs/src/changelog/v0.16/banner.png b/docs/src/changelog/v0.16/banner.png
new file mode 100644
index 0000000000..8179f14afd
Binary files /dev/null and b/docs/src/changelog/v0.16/banner.png differ