add note related to issue #37027

doc/topics/solaris/index.rst

@@ -0,0 +1,13 @@
+=======
+Solaris
+=======
+
+This section contains details on Solaris specific quirks and workarounds.
+
+.. note::
+   Solaris refers to both Solaris 10 comaptible platforms like Solaris 10, illumos, SmartOS, OmniOS, OpenIndiana,... and Oracle Solaris 11 platforms.
+
+.. toctree::
+    :glob:
+
+    *

doc/topics/solaris/solaris-specific-behavior.rst

@@ -0,0 +1,29 @@
+==========================
+Solaris-specific Behaviour
+==========================
+
+Salt is capable of managing Solaris systems, however due to various differences
+between the operating systems, there are some things you need to keep in mind.
+
+This document will contain any quirks that apply across Salt or limitations in
+some modules.
+
+
+FQDN/UQDN
+=========================
+On Solaris platforms the FQDN will not always be properly detected.
+If an IPv6 address is configured pythons ```socket.getfqdn()``` fails to return 
+a FQDN and returns the nodename instead. For a full breakdown see the following 
+issue on github: #37027
+
+Grains
+=========================
+Not all grains are available or some have empty or 0 as value. Mostly grains 
+that are depenend on hardware discovery like:
+- num_gpus
+- gpus
+
+Also some resolver related grains like:
+- domain
+- dns:options
+- dns:sortlist