Document the need for migrating tool to user lockfiles for export (Ch…

…erry-pick of #20604) (#20615)

backports [here](pantsbuild/pantsbuild.org#157)

Co-authored-by: Daniel Goldman <[email protected]>

docs/docs/python/overview/lockfiles.mdx

@@ -184,6 +184,9 @@ It is strongly recommended that these tools be installed from a hermetic lockfil
 
 The only time you need to think about this is if you want to customize the tool requirements that Pants uses. This might be the case if you want to modify the version of a tool or add extra requirements (for example, tool plugins).
 
+:::caution Exporting tools requires a custom lockfile
+:::
+
 If you want a tool to be installed from some resolve, instead of from the built-in lockfile, you set `install_from_resolve` and `requirements` on the tool's config section:
 
 ```toml title="pants.toml"

docs/docs/using-pants/setting-up-an-ide.mdx

@@ -49,7 +49,7 @@ The `--py-resolve-format=symlinked_immutable_virtualenv` option symlinks to an i
 
 ### Tool virtualenvs
 
-`pants export` can also create a virtualenv for each of the Python tools you use via Pants, such as `black`, `isort`, `pytest`, `mypy`, `flake8` and so on (you can run `/pants help tools` to get a list of the tools Pants uses). Use the tool name as the resolve name argument to the `--resolve` flag. This allows you to configure your editor to use the same version of the tool as Pants does for workflows like formatting on save.
+`pants export` can also create a virtualenv for each of the Python tools you use via Pants, such as `black`, `isort`, `pytest`, `mypy`, `flake8` and so on. This allows you to configure your editor to use the same version of the tool as Pants does for workflows like formatting on save. Follow [the instructions for creating a tool lockfile](../../python/overview/lockfiles#lockfiles-for-tools).
 
 ## Generated code
 

src/python/pants/core/goals/export.py

@@ -31,6 +31,7 @@
 from pants.option.option_types import StrListOption
 from pants.util.dirutil import safe_rmtree
 from pants.util.frozendict import FrozenDict
+from pants.util.strutil import softwrap
 
 
 class ExportError(Exception):
@@ -104,7 +105,15 @@ class ExportResults(Collection[ExportResult]):
 
 class ExportSubsystem(GoalSubsystem):
     name = "export"
-    help = "Export Pants data for use in other tools, such as IDEs."
+    help = softwrap(
+        """
+        Export Pants data for use in other tools, such as IDEs.
+
+        :::caution Exporting tools requires creating a custom lockfile for them
+        Follow [the instructions for creating tool lockfiles](../../docs/python/overview/lockfiles#lockfiles-for-tools)
+        :::
+        """
+    )
 
     # NB: Only options that are relevant across many/most backends and languages
     #  should be defined here.  Backend-specific options should be defined in that backend