add documentation for symlink

Taking it off the secret menu :)
Merge pull request #7542 from sjkelly/patch-1

add documentation for symlink