プロポーザル文書の問題点
Swift Evolutionのプロポーザルは、設計上詳細に書かれています。動機、詳細な設計、検討した代替案、ABIへの影響など、あらゆる側面をカバーしています。この詳細さはレビュープロセスには不可欠ですが、プロポーザルが何をしてなぜ重要なのかを理解したいだけの場合、何千語も読むのは大変です。
URLのコツ
GitHubで任意のSwift Evolutionプロポーザルの要約版を取得する簡単な方法があります。以下のようなURLでプロポーザルを閲覧しているとき：
https://github.com/apple/swift-evolution/blob/main/proposals/0390-noncopyable-structs-and-enums.mdappleをFlineDevに置き換えます：
https://github.com/FlineDev/swift-evolution/blob/main/proposals/0390-noncopyable-structs-and-enums.mdこれにより、プロポーザルの冒頭にAI生成の要約が追加されたswift-evolutionリポジトリのフォークに移動します。各要約は、プロポーザルが導入するもの、その重要性、基本的な構文などの要点を数段落にまとめています。
これが役立つ場面
これは、リリースノートやSNSでプロポーザルが言及されているのを見て、概要をすぐに理解したいときに特に便利です。完全なプロポーザルを15分かけて読む代わりに、数分で重要な情報を得ることができます。
要約は最近採択されたプロポーザルの多くをカバーしています。フォーク以前の古いプロポーザルについては元のテキストが表示されます。しかし、ここ数年のSwift Evolutionのプロポーザルについては、要約版は本当に時間の節約になります。
同じプロポーザルの核心的なアイデアだけを繰り返し流し読みしていることに気づいたので、このフォークを作りました。他の開発者にも同じショートカットが役立つだろうと思ったからです。