Skip to content

Conversation

stzn
Copy link
Owner

@stzn stzn commented Sep 6, 2025

Closes #647

@stzn stzn requested a review from Copilot September 6, 2025 23:31
Copy link

@Copilot 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

Adds documentation guidelines for upcoming Swift language features that can be enabled via feature flags before becoming default. This establishes a standard format for documenting experimental or preview features.

  • Adds a new "upcoming features" section to the style guide
  • Provides template language for feature documentation with version and identifier information
  • References SE-0362 implementation for piecemeal adoption of language improvements

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.


将来の機能に関するセクションまたは章の冒頭に、次のような注記を含めてください。

> 注: この言語機能は Swift *n* の一部となります。現在のバージョンの Swift でこの機能を有効にするには、機能識別子 `SomeFeatureIdentifier` を使用してください。将来の言語機能の有効化については、[将来の言語機能の有効化](https://github.com/swiftlang/swift-migration-guide/blob/main/Guide.docc/FeatureMigration.md)をご覧ください。
Copy link
Preview

Copilot AI Sep 6, 2025

Choose a reason for hiding this comment

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

The template note contains placeholder text 'n' and 'SomeFeatureIdentifier' that should be explained or formatted differently. Consider adding clarification that these are placeholders to be replaced with actual values, or use a more obvious placeholder format like {version} and {feature-identifier}.

Suggested change
> 注: この言語機能は Swift *n* の一部となります。現在のバージョンの Swift でこの機能を有効にするには、機能識別子 `SomeFeatureIdentifier` を使用してください。将来の言語機能の有効化については、[将来の言語機能の有効化](https://github.com/swiftlang/swift-migration-guide/blob/main/Guide.docc/FeatureMigration.md)をご覧ください
> **注:** 以下の `{version}` および `{feature-identifier}` は、実際の Swift のバージョン番号および機能識別子に置き換えてください
> 注: この言語機能は Swift {version} の一部となります。現在のバージョンの Swift でこの機能を有効にするには、機能識別子 `{feature-identifier}` を使用してください。将来の言語機能の有効化については、[将来の言語機能の有効化](https://github.com/swiftlang/swift-migration-guide/blob/main/Guide.docc/FeatureMigration.md)をご覧ください。

Copilot uses AI. Check for mistakes.

@stzn stzn merged commit b408c1b into master Sep 13, 2025
1 check passed
@stzn stzn deleted the upcoming branch September 13, 2025 22:55
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.

Upcoming featureについての記載を追加
1 participant