STDLibs


(James Campbell) #1

Is there a way of improving the documentation and hosting it on Swift
instead of Apple ?

Currently the Array page lists all of the things the class directly
implements but doesn't include any of the methods mixed in by protocol
extensions (i.e all of the methods from CollectionType).

With YardDoc for Ruby it does this, so you know exactly what methods a
class has.

This confused me to no end as some topics here suggest adding ways of
dropping the first X elements and even I have implemented `shift` which I
didn't know already exist albeit under another name.

Would be great if we could improve these documents for the language in an
open source way :slight_smile:

···

--
 Wizard
james@supmenow.com
+44 7523 279 698


(Trent Nadeau) #2

Big +1 from me. Rust's docs do this well too across trait implementations.

···

On Wed, Jan 6, 2016 at 5:43 AM, James Campbell via swift-evolution < swift-evolution@swift.org> wrote:

Is there a way of improving the documentation and hosting it on Swift
instead of Apple ?

Currently the Array page lists all of the things the class directly
implements but doesn't include any of the methods mixed in by protocol
extensions (i.e all of the methods from CollectionType).

With YardDoc for Ruby it does this, so you know exactly what methods a
class has.

This confused me to no end as some topics here suggest adding ways of
dropping the first X elements and even I have implemented `shift` which I
didn't know already exist albeit under another name.

Would be great if we could improve these documents for the language in an
open source way :slight_smile:

--
 Wizard
james@supmenow.com
+44 7523 279 698

_______________________________________________
swift-evolution mailing list
swift-evolution@swift.org
https://lists.swift.org/mailman/listinfo/swift-evolution

--
Trent Nadeau


(Erica Sadun) #3

Have you stopped by swiftdoc.org <http://swiftdocs.org/> recently?

:slight_smile:

-- Erica

···

On Jan 6, 2016, at 3:43 AM, James Campbell via swift-evolution <swift-evolution@swift.org> wrote:

Is there a way of improving the documentation and hosting it on Swift instead of Apple ?

Currently the Array page lists all of the things the class directly implements but doesn't include any of the methods mixed in by protocol extensions (i.e all of the methods from CollectionType).

With YardDoc for Ruby it does this, so you know exactly what methods a class has.

This confused me to no end as some topics here suggest adding ways of dropping the first X elements and even I have implemented `shift` which I didn't know already exist albeit under another name.

Would be great if we could improve these documents for the language in an open source way :slight_smile:

--
 Wizard
james@supmenow.com <mailto:james@supmenow.com>
+44 7523 279 698
_______________________________________________
swift-evolution mailing list
swift-evolution@swift.org
https://lists.swift.org/mailman/listinfo/swift-evolution


(James Campbell) #4

Chris do you think there is scope for this ?

···

On Wed, Jan 6, 2016 at 2:38 PM, Trent Nadeau <tanadeau@gmail.com> wrote:

Big +1 from me. Rust's docs do this well too across trait implementations.

On Wed, Jan 6, 2016 at 5:43 AM, James Campbell via swift-evolution < > swift-evolution@swift.org> wrote:

Is there a way of improving the documentation and hosting it on Swift
instead of Apple ?

Currently the Array page lists all of the things the class directly
implements but doesn't include any of the methods mixed in by protocol
extensions (i.e all of the methods from CollectionType).

With YardDoc for Ruby it does this, so you know exactly what methods a
class has.

This confused me to no end as some topics here suggest adding ways of
dropping the first X elements and even I have implemented `shift` which I
didn't know already exist albeit under another name.

Would be great if we could improve these documents for the language in an
open source way :slight_smile:

--
 Wizard
james@supmenow.com
+44 7523 279 698

_______________________________________________
swift-evolution mailing list
swift-evolution@swift.org
https://lists.swift.org/mailman/listinfo/swift-evolution

--
Trent Nadeau

--
 Wizard
james@supmenow.com
+44 7523 279 698


(Chris Lattner) #5

This is a complicated topic, I’d suggest asking on swift-users or swift-dev since it isn’t related to language evolution.

-Chris

···

On Jan 6, 2016, at 10:47 AM, James Campbell via swift-evolution <swift-evolution@swift.org> wrote:

Chris do you think there is scope for this ?

On Wed, Jan 6, 2016 at 2:38 PM, Trent Nadeau <tanadeau@gmail.com <mailto:tanadeau@gmail.com>> wrote:
Big +1 from me. Rust's docs do this well too across trait implementations.

On Wed, Jan 6, 2016 at 5:43 AM, James Campbell via swift-evolution <swift-evolution@swift.org <mailto:swift-evolution@swift.org>> wrote:
Is there a way of improving the documentation and hosting it on Swift instead of Apple ?

Currently the Array page lists all of the things the class directly implements but doesn't include any of the methods mixed in by protocol extensions (i.e all of the methods from CollectionType).

With YardDoc for Ruby it does this, so you know exactly what methods a class has.

This confused me to no end as some topics here suggest adding ways of dropping the first X elements and even I have implemented `shift` which I didn't know already exist albeit under another name.

Would be great if we could improve these documents for the language in an open source way :)

--
 Wizard
james@supmenow.com <mailto:james@supmenow.com>
+44 7523 279 698 <tel:%2B44%207523%20279%20698>
_______________________________________________
swift-evolution mailing list
swift-evolution@swift.org <mailto:swift-evolution@swift.org>
https://lists.swift.org/mailman/listinfo/swift-evolution

--
Trent Nadeau

--
 Wizard
james@supmenow.com <mailto:james@supmenow.com>
+44 7523 279 698
_______________________________________________
swift-evolution mailing list
swift-evolution@swift.org
https://lists.swift.org/mailman/listinfo/swift-evolution


(James Campbell) #6

I did but it redirects elsewhere now :S

···

On Wed, Jan 6, 2016 at 6:50 PM, Erica Sadun <erica@ericasadun.com> wrote:

Have you stopped by swiftdoc.org <http://swiftdocs.org> recently?

:slight_smile:

-- Erica

On Jan 6, 2016, at 3:43 AM, James Campbell via swift-evolution < > swift-evolution@swift.org> wrote:

Is there a way of improving the documentation and hosting it on Swift
instead of Apple ?

Currently the Array page lists all of the things the class directly
implements but doesn't include any of the methods mixed in by protocol
extensions (i.e all of the methods from CollectionType).

With YardDoc for Ruby it does this, so you know exactly what methods a
class has.

This confused me to no end as some topics here suggest adding ways of
dropping the first X elements and even I have implemented `shift` which I
didn't know already exist albeit under another name.

Would be great if we could improve these documents for the language in an
open source way :slight_smile:

--
 Wizard
james@supmenow.com
+44 7523 279 698
_______________________________________________
swift-evolution mailing list
swift-evolution@swift.org
https://lists.swift.org/mailman/listinfo/swift-evolution

--
 Wizard
james@supmenow.com
+44 7523 279 698


(Douglas Gregor) #7

I did but it redirects elsewhere now :S

It’s “swiftdoc.org”, not “swiftdocs.org” as in the link.

  - Doug

···

On Jan 6, 2016, at 11:06 AM, James Campbell via swift-evolution <swift-evolution@swift.org> wrote:

On Wed, Jan 6, 2016 at 6:50 PM, Erica Sadun <erica@ericasadun.com <mailto:erica@ericasadun.com>> wrote:
Have you stopped by swiftdoc.org <http://swiftdocs.org/> recently?

:slight_smile:

-- Erica

On Jan 6, 2016, at 3:43 AM, James Campbell via swift-evolution <swift-evolution@swift.org <mailto:swift-evolution@swift.org>> wrote:

Is there a way of improving the documentation and hosting it on Swift instead of Apple ?

Currently the Array page lists all of the things the class directly implements but doesn't include any of the methods mixed in by protocol extensions (i.e all of the methods from CollectionType).

With YardDoc for Ruby it does this, so you know exactly what methods a class has.

This confused me to no end as some topics here suggest adding ways of dropping the first X elements and even I have implemented `shift` which I didn't know already exist albeit under another name.

Would be great if we could improve these documents for the language in an open source way :slight_smile:

--
 Wizard
james@supmenow.com <mailto:james@supmenow.com>
+44 7523 279 698 <tel:%2B44%207523%20279%20698> _______________________________________________
swift-evolution mailing list
swift-evolution@swift.org <mailto:swift-evolution@swift.org>
https://lists.swift.org/mailman/listinfo/swift-evolution

--
 Wizard
james@supmenow.com <mailto:james@supmenow.com>
+44 7523 279 698
_______________________________________________
swift-evolution mailing list
swift-evolution@swift.org
https://lists.swift.org/mailman/listinfo/swift-evolution