swiftlang/swift

[SR-3752] Remove redundant word "Index" from Collection properties/typealiases

Open

#46,337 创建于 2017年1月26日

在 GitHub 查看
 (1 评论) (0 反应) (0 负责人)Swift (69,989 star) (10,719 fork)batch import
affects ABIgood first issueimprovementstandard libraryswift evolution proposal needed

描述
Previous ID SR-3752
Radar rdar://problem/29976316
Original Reporter @airspeedswift
Type Improvement
Votes 0
Component/s Standard Library
Labels Improvement, AffectsABI, StarterProposal
Assignee None
Priority Medium

md5: 0c809e36d2916cefa628bdb99c61a0e8

Issue Description:

The two properties "startIndex" and "endIndex", and the typealias IndexDistance should have the word "Index" removed, in order to reduce clutter. The meaning is clear without it.

For source compatibility reasons, deprecated computed properties or a typealias should be provided.

贡献者指南

技术栈
swift
领域
developer experience
议题类型
refactor
难度面向新贡献者的预计实现难度，1 表示很小改动，5 表示专家级工作。
2
预计时间有经验贡献者完成调查、实现、测试并准备 pull request 的粗略时间范围。
1-3 hours
活动状态议题当前的可参与程度：新鲜、活跃、陈旧、阻塞或等待维护者输入。
stale
清晰度议题是否清楚说明期望改动、验收标准和下一步。
clear
前置要求
Swift programming languageDeprecation attribute usage
新手友好度1-100 的估计分数，表示该议题对首次贡献者的友好程度。
80
研究方向
Locate the definitions of `startIndex`, `endIndex`, and `IndexDistance` in the Swift standard library source code (likely in `stdlib/public/core/Collection.swift` or similar). Add deprecated computed properties `start` and `end` for `startIndex` and `endIndex`, and a deprecated typealias `Distance` for `IndexDistance`. Ensure the deprecation warning message guides users to the new names. Test that existing code using the old names compiles with deprecation warnings. Refer to similar past deprecations in the Swift project for patterns.
[SR-3752] Remove redundant word "Index" from Collection properties/typealiases · swiftlang/swift#46337 | Good First Issue