[swift-evolution] API Guidelines Update
Charles Kissinger
crk at akkyra.com
Thu Feb 18 18:30:35 CST 2016
> On Feb 18, 2016, at 4:07 PM, Dave Abrahams <dabrahams at apple.com> wrote:
>
> Thanks, Charles! Could I entice you to submit a pull request against
> https://github.com/apple/swift-internals/blob/gh-pages/api-design-guidelines/index.md
> with these changes?
Will do.
> (You can do this entirely on GitHub by clicking on the pencil at the top).
>
> on Thu Feb 18 2016, Charles Kissinger <crk-AT-akkyra.com> wrote:
>
>> 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
>
> --
> -Dave
More information about the swift-evolution
mailing list