Add some documentation

Author: wxtim

sphinx/api/configuration/file-creation.rst

@@ -116,6 +116,11 @@ root directory to install file targets with a relative path:
          ``~/.ssh/config`` to specify the user ID for logging into ``HOST``
          if required.
 
+      .. note::
+
+         * When installing files, broken symbolic links are rejected.
+         * When installing directories using Git or Rsync broken symlinks
+           will be copied.
 
    .. rose:conf:: file:TARGET