Das Problem mit Proposal-Dokumenten
Swift Evolution Proposals sind von Natur aus ausführlich. Sie behandeln Motivation, detailliertes Design, betrachtete Alternativen, ABI-Auswirkungen und mehr. Diese Gründlichkeit ist für den Review-Prozess unverzichtbar, aber wenn du nur verstehen willst, was ein Proposal macht und warum, kann das Durchlesen von tausenden Wörtern ganz schön viel sein.
Der URL-Trick
Es gibt eine einfache Möglichkeit, eine zusammengefasste Version jedes Swift Evolution Proposals auf GitHub zu bekommen. Wenn du ein Proposal unter einer URL wie dieser betrachtest:
https://github.com/apple/swift-evolution/blob/main/proposals/0390-noncopyable-structs-and-enums.mdErsetze apple durch FlineDev:
https://github.com/FlineDev/swift-evolution/blob/main/proposals/0390-noncopyable-structs-and-enums.mdDas führt dich zu einem Fork des swift-evolution Repository, in dem Proposals um KI-generierte Zusammenfassungen am Anfang ergänzt wurden. Jede Zusammenfassung destilliert die wichtigsten Punkte – was das Proposal einführt, warum es wichtig ist und die grundlegende Syntax – in wenige Absätze.
Wann das hilfreich ist
Das ist besonders nützlich, wenn du ein Proposal in Release Notes oder in sozialen Medien erwähnt siehst und schnell den Kern verstehen willst. Anstatt 15 Minuten mit dem vollständigen Proposal zu verbringen, bekommst du die wesentlichen Informationen in ein paar Minuten.
Die Zusammenfassungen decken die meisten kürzlich akzeptierten Proposals ab. Für ältere Proposals, die vor dem Fork erstellt wurden, siehst du weiterhin den Originaltext. Aber für alles aus den letzten Jahren der Swift Evolution ist die zusammengefasste Version ein echter Zeitsparer.
Ich habe diesen Fork erstellt, weil ich mich immer wieder dabei ertappt habe, Proposals nur nach der Kernidee zu durchsuchen, und dachte, dass andere Entwickler von der gleichen Abkürzung profitieren könnten.