Add a note explaining that Pkg.test can cause compilation errors and how to fix.

Add a note explaining that Pkg.test can cause compilation errors and how to fix. #11406