Skip to content

docs: PI 2.3.1 - 强调一下不兼容选项行为#1181

Merged
MistEO merged 3 commits intomainfrom
docs/PI_2.3.1
Mar 5, 2026
Merged

docs: PI 2.3.1 - 强调一下不兼容选项行为#1181
MistEO merged 3 commits intomainfrom
docs/PI_2.3.1

Conversation

@MistEO
Copy link
Copy Markdown
Member

@MistEO MistEO commented Mar 5, 2026

fix #1168

Summary by Sourcery

澄清 Project Interface v2.3.1 文档中,controller/resource 适用性约束如何影响选项激活以及 pipeline_override 合并行为。

Documentation:

  • 说明当选项的 controller/resource 约束条件不满足时,该选项应被视为未激活,且不得对 pipeline_override 做出任何贡献;这一规则同样适用于嵌套选项以及从 resource/controller/global 选项中引用的选项。
  • 更新 Project Interface v2 的版本历史,加入 v2.3.1,并在其中明确说明选项适用性及 pipeline_override 行为。
Original summary in English

Summary by Sourcery

Clarify how controller/resource applicability constraints affect option activation and pipeline_override merging in the Project Interface v2.3.1 documentation.

Documentation:

  • Document that options whose controller/resource constraints are not satisfied are treated as inactive and must not contribute any pipeline_override, including nested options and those referenced from resource/controller/global options.
  • Update the Project Interface v2 version history to include v2.3.1 with the clarified option applicability and pipeline_override behavior.

Copilot AI review requested due to automatic review settings March 5, 2026 11:02
Copy link
Copy Markdown
Contributor

@sourcery-ai sourcery-ai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

嗨——我已经审查了你的修改,看起来非常棒!


Sourcery 对开源项目是免费的——如果你觉得我们的评审对你有帮助,请考虑分享给更多人 ✨
帮我变得更有用!请在每条评论上点 👍 或 👎,我会根据你的反馈来改进后续的评审。
Original comment in English

Hey - I've reviewed your changes and they look great!


Sourcery is free for open source - if you like our reviews please consider sharing them ✨
Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the English ProjectInterface V2 documentation to explicitly specify how option applicability constraints (option.controller / option.resource) affect pipeline_override merging, including nested options and options referenced from different levels.

Changes:

  • Added PI version note for v2.3.1 documenting the clarified “inactive option” filtering behavior.
  • Clarified in multiple option-related sections that inapplicable options must not contribute any pipeline_override (including nested option.option).
  • Documented that global_option-referenced options still must satisfy their own controller/resource constraints.

@MistEO MistEO changed the title docs: 强调一下不兼容选项行为 docs: PI 2.3.1 - 强调一下不兼容选项行为 Mar 5, 2026
@MistEO MistEO merged commit 22024cc into main Mar 5, 2026
1 check passed
@MistEO MistEO deleted the docs/PI_2.3.1 branch March 5, 2026 11:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

PI 明确下:对于不支持的option.controller,不应用任何一个 pipeline_override

2 participants