Repository: pantsbuild/pants

Issue:
pythonpath option default documentation is set to various jsirois values
**Issue**: defaults are set to a specific user's values (@jsirois)
**Expected**: actual defaults that aren't specific to a user

I'd be happy to make a PR if I knew where the docs page src was.

**Repro**:

From here https://www.pantsbuild.org/options_reference.html:

```
--pythonpath="['<str>', '<str>', ...]" (default: "['/home/jsirois/dev/pantsbuild/pants/contrib/avro/src/python', '/home/jsirois/dev/pantsbuild/pants/contrib/awslambda/python/src/python', '/home/jsirois/dev/pantsbuild/pants/contrib/buildrefactor/src/python', '/home/jsirois/dev/pantsbuild/pants/contrib/codeanalysis/src/python', '/home/jsirois/dev/pantsbuild/pants/contrib/cpp/src/python', '/home/jsirois/dev/pantsbuild/pants/contrib/confluence/src/python', '/home/jsirois/dev/pantsbuild/pants/contrib/errorprone/src/python', '/home/jsirois/dev/pantsbuild/pants/contrib/findbugs/src/python', '/home/jsirois/dev/pantsbuild/pants/contrib/go/src/python', '/home/jsirois/dev/pantsbuild/pants/contrib/googlejavaformat/src/python', '/home/jsirois/dev/pantsbuild/pants/contrib/jax_ws/src/python', '/home/jsirois/dev/pantsbuild/pants/contrib/mypy/src/python', '/home/jsirois/dev/pantsbuild/pants/contrib/node/src/python', '/home/jsirois/dev/pantsbuild/pants/contrib/scalajs/src/python', '/home/jsirois/dev/pantsbuild/pants/contrib/scrooge/src/python', '/home/jsirois/dev/pantsbuild/pants/contrib/thrifty/src/python', '/home/jsirois/dev/pantsbuild/pants/pants-plugins/src/python']")
Add these directories to PYTHONPATH to search for plugins.
```

I'm *assuming* these were unintended.


Discussion:
Ah, interesting. That page is autogenerated by this custom Task (Pants dogfoods its plugin system here):
https://github.com/pantsbuild/pants/blob/8d2af15a38a2d52c9072bcbec2de07f7807ac644/src/python/pants/backend/docgen/tasks/generate_pants_reference.py#L17-L51

That's run by this script that's part of our release process and I was the last releaser. That script is here:
https://github.com/pantsbuild/pants/blob/8cbe5531cb3a9043dba4e40bc48df1ea99b3dd1b/build-support/bin/publish_docs.sh#L66-L69

Is this something you'd be willing to hack on?
Still an issue with the new docs, too: https://www.pantsbuild.org/docs/reference-global

These are generated in https://github.com/pantsbuild/pants/blob/master/build-support/bin/generate_docs.py.

To fix, I think we can find the pwd for the current user, then replace that value with something generic like `/users/pantsbuild/pants`

Resolving patch:
diff --git a/src/python/pants/option/global_options.py b/src/python/pants/option/global_options.py
--- a/src/python/pants/option/global_options.py
+++ b/src/python/pants/option/global_options.py
@@ -600,6 +600,7 @@ class BootstrapOptions:
         "--pants-version",
         advanced=True,
         default=pants_version(),
+        default_help_repr="<pants_version>",
         daemon=True,
         help=softwrap(
             f"""
@@ -1024,6 +1025,7 @@ class BootstrapOptions:
             """
         ),
         default=tempfile.gettempdir(),
+        default_help_repr="<tmp_dir>",
     )
     local_cache = BoolOption(
         "--local-cache",
@@ -1276,6 +1278,9 @@ class BootstrapOptions:
             See `--remote-execution-headers` as well.
             """
         ),
+        default_help_repr=repr(DEFAULT_EXECUTION_OPTIONS.remote_store_headers).replace(
+            VERSION, "<pants_version>"
+        ),
     )
     remote_store_chunk_bytes = IntOption(
         "--remote-store-chunk-bytes",
@@ -1384,6 +1389,9 @@ class BootstrapOptions:
             See `--remote-store-headers` as well.
             """
         ),
+        default_help_repr=repr(DEFAULT_EXECUTION_OPTIONS.remote_execution_headers).replace(
+            VERSION, "<pants_version>"
+        ),
     )
     remote_execution_overall_deadline_secs = IntOption(
         "--remote-execution-overall-deadline-secs",


Test patch: