Re-enable go_path_test and document copy behavior (#1710)

go_path_test no longer checks whether files are symbolic links or
regular files. Bazel may provide either.

This is now noted in the documentation for go_path.

We will keep both modes for now to avoid breaking anyone depending on
the API. There is a difference in behavior with file / tree artifacts.

Fixes #1699