add docs entry

Author: tim-werner

docs/notes/2.32.x.md

@@ -81,6 +81,12 @@ The option `[docker].push_on_package` can be used to prevent Docker images from
 
 Running `pants publish` on a `docker_image` target with `skip_push=True` will no longer package the `docker_image`.
 
+The option `[docker].build_extra_options` or/and the `build_extra_options` field of `docker_image` targets can now be used to pass extra options to docker build or podman build. Make sure that the options are understood by the tool.
+For example, you can now set `build_extra_options=["--no-cache"]` to do not use existing cached images for the container build.
+
+Fields that are already present in the docker image target are surpressed by the extra options when they conflict. 
+For example, if you set `build_extra_options=["--pull"]`, the `pull` field of the docker image target will be ignored. 
+
 #### Helm
 
 When `pants publish` is invoked, Pants will now skip packaging for `helm_chart` targets if either `skip_push=True` or the target has no registries.

src/python/pants/backend/docker/goals/package_image.py

@@ -429,7 +429,6 @@ def get_build_options(
     if global_build_no_cache_option:
         extra_options = extra_options + ("--no-cache",)
 
-    # Append extra options last so that they take precedence over the structured fields above.
     yield from extra_options
 
 

src/python/pants/backend/docker/goals/package_image_test.py

@@ -3006,7 +3006,7 @@ def check_build_process(result: DockerImageBuildProcess):
 
 
 def test_extra_build_options_global_and_target_merged(rule_runner: RuleRunner) -> None:
-    """Global options come first; per-target options come last."""
+    """Global options and per-target options should be merged correctly."""
     rule_runner.set_options(
         [],
         env={
@@ -3072,7 +3072,7 @@ def test_global_extra_options_overridden_by_target_extra_options(
     rule_runner: RuleRunner,
 ) -> None:
     """When both global and target extra options specify the same flag, the target wins
-    (it comes last) and the global does not appear."""
+    and the global does not appear."""
     rule_runner.set_options(
         [],
         env={