diff --git a/docs/markdown/snippets/solaris.md b/docs/markdown/snippets/solaris.md
new file mode 100644
index 000000000..78f57187b
--- /dev/null
+++ b/docs/markdown/snippets/solaris.md
@@ -0,0 +1,4 @@
+## Better support for illumos and Solaris
+
+illumos (and hopefully Solaris) support has been dramatically improved, and one
+can reasonably expect projects to compile.