Reposting from thread on swift-evolution: Big +1 from me. Rust's docs do this well too across trait implementations. See, for example, https://doc.rust-lang.org/std/fs/struct.File.html.
On Wed, Jan 6, 2016 at 5:22 PM, Ted kremenek via swift-dev < [email protected]> wrote: > Hi James, > > We're interested in hosting documentation on Swift.org <http://swift.org> > for a variety of reasons. One motivating reason is to showcase the > documentation for the version of the Standard Library that is in active > development on 'master'. For example, whenever we generate a new snapshot > that can be downloaded we update posted documentation. > > We're exploring various options. If you have specific suggestions on what > you would like to see, please speak up. > > Thanks, > Ted > > On Jan 6, 2016, at 11:06 AM, James Campbell via swift-dev < > [email protected]> 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 > [email protected] > +44 7523 279 698 > > _______________________________________________ > swift-dev mailing list > [email protected] > https://lists.swift.org/mailman/listinfo/swift-dev > > > _______________________________________________ > swift-dev mailing list > [email protected] > https://lists.swift.org/mailman/listinfo/swift-dev > > -- Trent Nadeau
_______________________________________________ swift-dev mailing list [email protected] https://lists.swift.org/mailman/listinfo/swift-dev
