[swift-evolution] [Proposal] Replace all Swift comments by end notes.

Amir Michail a.michail at me.com
Mon Jan 16 09:28:18 CST 2017

Why not replace all Swift comments by end notes at the end of each source file so as to minimize the impact of misleading/outdated comments on code comprehension?

You don’t necessarily need to scroll to the end of the source file to read a referenced end note in the code since the IDE could show a popup whenever the mouse pointer lingers over an end note reference (e.g., a number/label).

Maybe this would encourage programmers to write more self-explanatory code while keeping (end note) comments to a minimum?

More information about the swift-evolution mailing list