Content review: content/docs/iac/concepts/providers/_index.md

[pulumi-bot]

Important

This PR is set to auto-merge (squash). Once it has an approving review and the required build check passes, GitHub will merge it automatically — approving this PR will merge it. To prevent that, disable auto-merge (or convert the PR back to a draft) before approving.

Why this page

• Page: content/docs/iac/concepts/providers/_index.md → /docs/iac/concepts/providers/
• Lane: priority
• Strategic tier: 1 (no_retire: true)
• Traffic: 3,466 monthly visits (period 2026-01-20 to 2026-07-20; source CLICKSTREAM.FCT_PAGEVIEWS)
• Last reviewed: never (attempts: 0)
• Selection score: 24.7369

This section is composed deterministically from the selection queue; do not edit it.

Fixes applied

Claim / finding	Authoritative source	Correction
Claim (c65, L658): The Automation API Go SDK's stack.SetConfig method accepts a boolean true argument to set pulumi:disable-default-providers[0] as a path.	gh search code "func (s *Stack) SetConfig" --repo pulumi/pulumi (sdk/go/auto/stack.go)	The Go SetConfig(ctx, key, val) signature takes no path argument, so the sample did not compile. Replaced it with the path-aware method: stack.SetConfigWithOptions(ctx, "pulumi:disable-default-providers[0]", auto.ConfigValue{Value: "*"}, &auto.ConfigOptions{Path: true}).
Readthrough orphaned-structure (L605-607): "Disabling explicit providers will help ensure that the [provider resource option](/docs/iac/conce…"	readthrough coherence pass	Section is titled "Disabling default providers" and every surrounding sentence is about default providers; the tip incorrectly said "explicit." Changed "Disabling explicit providers" → "Disabling default providers" (disabling default providers is what forces the provider option to be set).

Findings not applied

• Claim (c6): Native providers are not bridged; they are generated from a cloud or service's API specification… — unverifiable — The cited source is the pulumi-terraform-bridge repo, which describes bridged (Terraform-derived) providers, not native/API-spec-generated ones, so it neither confirms nor contradicts the claim; correcting the reference is judgment-level, not a fact fix.
• Claim (c18): The Any Terraform Provider is a parameterized provider that allows generating a local provider SDK when a pre-built provider SDK does not exist… — unverifiable — The cited https://search.opentofu.org link fetched as a client-rendered shell (title only, no body text), so the source couldn't confirm the framing; the statement is well-corroborated elsewhere on the same page, so this is a citation-target concern for a human, not a factual error.
• Claim (c58): Running pulumi config set --path 'pulumi:disable-default-providers[0]' aws disables the aws default provider. — unverifiable — Verification did not converge within its turn budget; the CLI example is internally consistent with the surrounding section (and with the verified c59/c60), so there's no evidenced correction to apply.
• Vale difficulty qualifier (L253): Avoid difficulty qualifier 'simply' (STYLE-GUIDE.md §Inclusive Language). — Not stamped deterministic_fix, so this is a style nag with no Vale-authored replacement; removing "simply" is a prose edit for a human, not a mechanical fix.
• Readthrough self-redundancy (L36, 65-84): parameterized-provider rationale restated across two sections. — local_repair, but the proposed fix offers two alternatives and L36 uniquely carries the Azure Native parameterized example (absent from the later section); deciding what to trim without losing that content is editorial.
• Readthrough orphaned-structure (L455-457): stray pulumi config set aws:region us-west-2 block. — local_repair, but claim c46 treats this command as the config that lands the example's listener in us-west-2; it's meaningful context, so the real repair is adding explanatory prose (authoring), not the deletion alternative.
• Vale filler (L48): Don't start a sentence with 'There are'. — Style nag, no deterministic_fix; rewording "There are two methods…" is a prose judgment.
• Vale future tense (L63): Future tense ('the Pulumi CLI will install') — prefer present tense (STYLE-GUIDE.md §Grammar). — Style nag; recasting to present tense is a prose judgment, not a mechanical fix.
• Vale wordiness (L84): 'all of' is too wordy. — Style nag; the phrasing is inside a longer clause and trimming it is a prose judgment.
• Vale narrative voice (L166): Narrative walkthrough voice ('let's') — prefer imperative second person (STYLE-GUIDE.md §Grammar). — Style nag; rewriting "let's look at a detailed example" is a prose judgment.
• Vale future tense (L606): Future tense ('the resource will use') — prefer present tense (STYLE-GUIDE.md §Grammar). — Style nag; recasting to present tense is a prose judgment.

For the judgment-level items above, run /glow-up content/docs/iac/concepts/providers/_index.md.

Screenshot check

No images. The page source references no screenshots, diagrams, or other content images (only the generic shared meta_image card, if any), so there is nothing to verify. (Determined from the source; the screenshot pass was skipped.)

Rendered content

Skipped — the page source uses only render-safe chrome (choosable, chooser, notes), so the rendered HTML and markdown carry no content beyond the source prose (nothing data-sourced or partial-included to fact-check). No make build or rendered pass required. (Determined from the source.)

Verification

• make lint: ✅ make lint re-verified by the workflow on 89261a4cf6
• Pre-step artifacts:
  • .verified-claims.json: 66 verdict(s); 1 contradicted/mismatch, 3 unverifiable
  • .vale-findings.json: 6 finding(s)
  • .readthrough-findings.json: ran=True, 3 finding(s)
  • .frontmatter-validation.json: 1 file(s); 0 alias collision(s)

[github-actions]

🔍 Triage prose check — possible issues in the diff. Full review is skipped (review:trivial); please double-check before merging.

• [style] content/docs/iac/concepts/providers/_index.md:606 — future tense: Future tense ('the resource will use') -- prefer present tense for product behavior: 'Neo pauses', not 'Neo will pause' (STYLE-GUIDE.md §Grammar and punctuation).

This is a simplified spelling/grammar/style check in lieu of a full review. Reject false positives at your discretion.

[pulumi-bot]

Your site preview for commit 89261a4 is ready! 🎉

http://www-testing-pulumi-docs-origin-pr-20503-89261a4c.s3-website.us-west-2.amazonaws.com

Changed pages:

• /docs/iac/concepts/providers/