<div dir="ltr">Reposting from thread on swift-evolution:<div><br></div><div><span style="font-size:13px">Big +1 from me. Rust's docs do this well too across trait implementations. See, for example, </span><a href="https://doc.rust-lang.org/std/fs/struct.File.html">https://doc.rust-lang.org/std/fs/struct.File.html</a>.<br></div></div><div class="gmail_extra"><br><div class="gmail_quote">On Wed, Jan 6, 2016 at 5:22 PM, Ted kremenek via swift-dev <span dir="ltr"><<a href="mailto:swift-dev@swift.org" target="_blank">swift-dev@swift.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="auto"><div></div><div>Hi James,</div><div><br></div><div>We're interested in hosting documentation on <a href="http://swift.org" target="_blank">Swift.org</a> 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.</div><div><br></div><div>We're exploring various options. If you have specific suggestions on what you would like to see, please speak up.</div><div><br></div><div>Thanks,</div><div>Ted</div><div><br>On Jan 6, 2016, at 11:06 AM, James Campbell via swift-dev <<a href="mailto:swift-dev@swift.org" target="_blank">swift-dev@swift.org</a>> wrote:<br><br></div><blockquote type="cite"><div><div dir="ltr"><div style="font-size:12.8px">Is there a way of improving the documentation and hosting it on Swift instead of Apple ?<br></div><div style="font-size:12.8px"><br></div><div style="font-size:12.8px">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).</div><div style="font-size:12.8px"><br></div><div style="font-size:12.8px">With YardDoc for Ruby it does this, so you know exactly what methods a class has.</div><div style="font-size:12.8px"><br></div><div style="font-size:12.8px">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.</div><div style="font-size:12.8px"><br></div><div style="font-size:12.8px">Would be great if we could improve these documents for the language in an open source way :)</div><div><br></div>-- <br><div><div dir="ltr"><div><div dir="ltr"><div dir="ltr"><div><span style="font-size:16px;line-height:19.2px"></span><span style="font-size:12.8px"> Wizard</span><br></div><div><a href="mailto:james@supmenow.com" target="_blank">james@supmenow.com</a></div><div><a href="tel:%2B44%207523%20279%20698" value="+447523279698" target="_blank">+44 7523 279 698</a></div></div></div></div></div></div>
</div>
<img src="https://u2002410.ct.sendgrid.net/wf/open?upn=cUTXn2XUQg0NGOEWHTVTyDr9W6Is2djHPo9bUJUJ-2FRboFnu618UAc6KmAasIpkbjbdqWqJ-2BPSQkXObG2oTPCTluAQK95ZdOO7rxlXGyDWFPiGmn5gImKhpODsrpQ7QTnbohecaOvA7lwePcxtjbTe2N2a6hJ8mybbCp-2BW1tvm8-2FHhXloxXVI6qTEA0paHAVhK9C6QMDJ-2BtPVdnqkBi0cgyALQyOUk8ioU84hHanL2Ss-3D" alt="" width="1" height="1" border="0" style="min-height:1px!important;width:1px!important;border-width:0!important;margin-top:0!important;margin-bottom:0!important;margin-right:0!important;margin-left:0!important;padding-top:0!important;padding-bottom:0!important;padding-right:0!important;padding-left:0!important">
</div></blockquote><blockquote type="cite"><div><span>_______________________________________________</span><br><span>swift-dev mailing list</span><br><span><a href="mailto:swift-dev@swift.org" target="_blank">swift-dev@swift.org</a></span><br><span><a href="https://lists.swift.org/mailman/listinfo/swift-dev" target="_blank">https://lists.swift.org/mailman/listinfo/swift-dev</a></span><br></div></blockquote>
<img src="https://u2002410.ct.sendgrid.net/wf/open?upn=PLxfwCJEjPeWvUDZqEq2h1e5BRs1s4m99sV2gcalz-2FRWeKaVXWfKAASL8Ssy6YIrVJlCKdEOS12RFHj50a8JR61byL9l6qD76wZgky9LVRtJ80c2RZYiOFvT-2BS2yX6fXtbL2H-2BOE4JvaSa70SPH5W3b691jdWs04PkDjal7MxALJ-2FMGcd-2FmmAhIy1GAg9W-2BQb9Mq-2BLJ1h2svHSulu-2FLvE-2FLHlv2lJkpObU-2B3Jz8ibnc-3D" alt="" width="1" height="1" border="0" style="min-height:1px!important;width:1px!important;border-width:0!important;margin-top:0!important;margin-bottom:0!important;margin-right:0!important;margin-left:0!important;padding-top:0!important;padding-bottom:0!important;padding-right:0!important;padding-left:0!important">
</div>
<br>_______________________________________________<br>
swift-dev mailing list<br>
<a href="mailto:swift-dev@swift.org">swift-dev@swift.org</a><br>
<a href="https://lists.swift.org/mailman/listinfo/swift-dev" rel="noreferrer" target="_blank">https://lists.swift.org/mailman/listinfo/swift-dev</a><br>
<br></blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature">Trent Nadeau</div>
</div>