fleshing out the symlinking docs

[mckayward]

This is a hard thing to explain. I definitely feel like this improves the docs, but I am certainly open to feedback on this. The updated docs are being served here.

[saiprashanths]

Looks great! Lets merge and push.