doc: clarify pm limitations and include symlink statement
This PR improves the "Limitations and known issues" section and includes a statement of relative symlinks.
Refs: https://github.com/nodejs-private/node-private/pull/413#issuecomment-1665749899