platform.rb in ohai-13.7.1

- old
+ new
@@ -117,17 +117,26 @@
   # @returns [String] platform_family value
   #
   def determine_platform_family
     case platform
     when /debian/, /ubuntu/, /linuxmint/, /raspbian/, /cumulus/
+      # apt-get+dpkg almost certainly goes here
       "debian"
     when /oracle/, /centos/, /redhat/, /scientific/, /enterpriseenterprise/, /xenserver/, /cloudlinux/, /ibm_powerkvm/, /parallels/, /nexus_centos/, /clearos/, /bigip/ # Note that 'enterpriseenterprise' is oracle's LSB "distributor ID"
+      # NOTE: "rhel" should be reserved exclusively for recompiled rhel versions that are nearly perfectly compatible down to the platform_version.
+      # The operating systems that are "rhel" should all be as compatible as rhel7 = centos7 = oracle7 = scientific7 (98%-ish core RPM version compatibility
+      # and the version numbers MUST track the upstream). The appropriate EPEL version repo should work nearly perfectly.  Some variation like the
+      # oracle kernel version differences and tuning and extra packages are clearly acceptable.  Almost certainly some distros above (xenserver?)
+      # should not be in this list.  Please use fedora, below, instead.  Also note that this is the only platform_family with this strict of a rule,
+      # see the example of the debian platform family for how the rest of the platform_family designations should be used.
       "rhel"
     when /amazon/
       "amazon"
     when /suse/
       "suse"
     when /fedora/, /pidora/, /arista_eos/
+      # In the broadest sense:  RPM-based, fedora-derived distributions which are not strictly re-compiled RHEL (if it uses RPMs, and smells more like redhat and less like
+      # SuSE it probably goes here).
       "fedora"
     when /nexus/, /ios_xr/
       "wrlinux"
     when /gentoo/
       "gentoo"