docs: nuance regarding flat interfaces

[otaviomacedo]

---

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license

[github-actions]

⚠️ This pull request description does not follow the correct template structure.

PRs without a linked issue will receive lower priority for review and merging. Please update the description to follow the PR template and include a line like Closes #123 in the Issue section. If no existing issue matches your change, create one first.

[mergify]

Thank you for contributing! Your pull request will be updated from main and then merged automatically (do not update manually, and be sure to allow changes to be pushed to your fork).

[mergify]

Merge Queue Status

• ✅ Entered queue — 2026-08-17 13:19 UTC · Rule: default-squash · triggered by rule automatic merge
• ✅ Checks skipped · PR is already up-to-date
• ✅ Merged — 2026-08-17 13:19 UTC · at 020fdb3be80ae24e7ca3587b1e2b6fe51f7d2d8d · squash

This pull request spent 23 seconds in the queue, including 3 seconds running CI.

Required conditions to merge

• github-review-approved [🛡 GitHub branch protection]
  • docs: nuance regarding flat interfaces #38584
• any of [🛡 GitHub branch protection]:
  • check-success = validate-pr
  • check-neutral = validate-pr
  • check-skipped = validate-pr
• any of [🛡 GitHub branch protection]:
  • check-success = build
  • check-neutral = build
  • check-skipped = build

[github-actions]

Comments on closed issues and PRs are hard for our team to see.
If you need help, please open a new issue that references this one.