Detailing -chdir behavior with terraform.d/plugin folders

[fnickels]

Fixes Bug reported in #31442

This PR is a 4th alternate implementation - documentation change to match code behavior.

Use instead if the following PRs are not workable:

• 3rd alternate fix to mirror directory bug #31456
• Apply the -chdir option before resolving implied provider filesystem mirror directories, and then reset it back #31452
• Apply the -chdir option before resolving implied provider filesystem mirror directories #31443

[crw]

Thanks for these documentation changes. I'll run these past the docs team for review.

[laurapacilio]

Hi @fnickels - thanks for adding this! I'm making a suggested edit to help with clarity and flow. Please let me know if I have misunderstood your intended meaning. Do you feel comfortable merging it in?

@crw After this, I would like a quick engineering technical 👍 as well - this is a case I'm not super familiar with and I want to make sure engineering is okay with this. Especially since there has been discussion about -chdir in other threads. Thank you!

[laurapacilio]

🚀 @crw - over to eng. for a final 👍

[crw]

For future reference: I believe this comment confirms the behavior as described in these docs changes. However, I'll queue this up for final review.

#31442 (comment)

[github-actions]

Reminder for the merging maintainer: if this is a user-visible change, please update the changelog on the appropriate release branch.

[github-actions]

I'm going to lock this pull request because it has been closed for 30 days ⏳. This helps our maintainers find and focus on the active contributions.
If you have found a problem that seems related to this change, please open a new issue and complete the issue template so we can capture all the details necessary to investigate further.