diff --git a/docs/markdown/snippets/split-compiler-and-linker-representations.md b/docs/markdown/snippets/split-compiler-and-linker-representations.md
new file mode 100644
index 000000000..fd2e62297
--- /dev/null
+++ b/docs/markdown/snippets/split-compiler-and-linker-representations.md
@@ -0,0 +1,6 @@
+## Compiler and dynamic linker representation split
+
+0.52.0 inclues a massive refactor of the representaitons of compilers to
+tease apart the representations of compilers and dynamic linkers (ld). This
+fixes a number of compiler/linker combinations. In particular this fixes
+use GCC and vanilla clang on macOS.
\ No newline at end of file