internals: improve error message when imports are found in a BUILD fi…

…le or a macro (pantsbuild#17940)

src/python/pants/engine/internals/parser.py

@@ -296,9 +296,9 @@ def error_on_imports(build_file_content: str, filepath: str) -> None:
             continue
         raise ParseError(
             f"Import used in {filepath} at line {lineno}. Import statements are banned in "
-            "BUILD files because they can easily break Pants caching and lead to stale results. "
-            f"\n\nInstead, consider writing a macro ({doc_url('macros')}) or "
-            f"writing a plugin ({doc_url('plugins-overview')}."
+            "BUILD files and macros (that act like a normal BUILD file) because they can easily "
+            "break Pants caching and lead to stale results. "
+            f"\n\nInstead, consider writing a plugin ({doc_url('plugins-overview')})."
         )