That sounds like we should probably look into what's going on there and why it doesn't work !
We should only really document that here if it's actually intended behaviour - if it's a bug, we should fix that, instead !
I'm still too new here to be know which is relevant.
One thing that crosses my mind: when you did your 'ln -s /opt/masterfiles /var/cfengine/masterfiles', was the owner of the symlink the same as the owner of its target; i.e., if you 'ls -ld /opt/masterfiles /var/cfengine/masterfiles' do both lines show the same user ?