[swift-evolution] [swift-evolution-announce] [Review] SE-0023 API Design Guidelines
Patrick Gili
gili.patrick.r at gili-labs.com
Fri Jan 29 10:27:17 CST 2016
Hi Erica,
This was in the documentation section, I didn't think this applied to the naming of functions/methods.
Cheers,
-Patrick
> On Jan 29, 2016, at 11:11 AM, Erica Sadun <erica at ericasadun.com> wrote:
>
>> Overall, I like the proposal. It provides sound guidance that can lead to consistent code in practice. However, there are some issues and concerns I have:
>>
>> - Under "Fundamentals", there is a bullet called "Write a documentation comment...". Under this bullet, this is another bullet called "Use a single sentence fragment...". Why? I find sentence fragments often detract from clarity and concise nature, which can lead to confusion.
>
> This fragment is added to the name of the function so if you have a function named "myFunction", the descriptive fragment is "converts integers to strings." and the display is:
>
> Description: myFunction converts integers to string.
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.swift.org/pipermail/swift-evolution/attachments/20160129/d33ea877/attachment.html>
More information about the swift-evolution
mailing list