[swift-evolution] API Guidelines Update
Charles Kissinger
crk at akkyra.com
Thu Feb 18 17:13:05 CST 2016
Three places where you might have intended different wording:
"Prefer names of function and other methods that make use sites form grammatical English phrases.”
Should it be:
"Prefer method and function names that make use sites form grammatical English phrases.” ?
“Initializer and factory methods calls should form a phrase that does not include the first argument, e.g.”
Should it be:
“Initializer and factory method calls should form a phrase that does not include the first argument, e.g.” ?
“Label closure parameters and the tuple members where they appear in your API.”
Should it be:
“Label closure parameters and tuple members where they appear in your API.” ?
Also, there appears to be a repeated “the” here:
/// **`byteCount`** equal to the the number of maximally-aligned
—CK
> On Feb 16, 2016, at 6:31 PM, Dave Abrahams via swift-evolution <swift-evolution at swift.org> wrote:
>
>
> I've updated the API guidelines document to account for the review
> feedback and other issues. Please see
> http://apple.github.io/swift-internals/api-design-guidelines/
> (presentation view)
> and
> https://github.com/apple/swift-internals/blob/gh-pages/api-design-guidelines/index.md
> (source and commit history)
>
> --
> -Dave
>
> _______________________________________________
> swift-evolution mailing list
> swift-evolution at swift.org
> https://lists.swift.org/mailman/listinfo/swift-evolution
More information about the swift-evolution
mailing list