Yes, switching easily between language version outside of Github would definitely be sweet. <br><br>The docs could even be organized as one or multiple playgrounds with pages. <br>Allowing to see the results live and play with it.<br><br>The learning by playing with it strategy of playground seem definitely adapted to this. <br><br>Hugues<br><br><div class="gmail_quote"><div dir="ltr">On Sat, Apr 16, 2016 at 03:18 Andrew Bennett <<a href="mailto:cacoyi@gmail.com">cacoyi@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">I think this is a great idea.<div><br></div><div>I'm not sure how big a task it is to open source the current system. Hopefully it's easy for Apple to extract the content, convert it to markdown (if needed), and allow it to be updated from a git repo. It would be great if the website allowed you to browse tagged release versions (without having to go to github).</div><div><br></div></div><div class="gmail_extra"><br><div class="gmail_quote"></div></div><div class="gmail_extra"><div class="gmail_quote">On Sat, Apr 16, 2016 at 1:40 AM, Hugues Bernet-Rollande via swift-evolution <span dir="ltr"><<a href="mailto:swift-evolution@swift.org" target="_blank">swift-evolution@swift.org</a>></span> wrote:<br></div></div><div class="gmail_extra"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div>Hi,<div><div><br></div><div>Not sure this request fit the swift evolution mailing list, but it would be great to have an open source (GitHub) version of the programming language guide (<a href="https://swift.org/documentation/#the-swift-programming-language" target="_blank">https://swift.org/documentation/#the-swift-programming-language</a>) in order to suggest edit regarding validated evolution and/or edit on the current version.</div><div><br></div><div>Using branches matching evolution named could ease doc update and tag to identify specific version evolution.</div><div><br></div><div>It will also facilitate any translation by homogenizing the guide structure, like the ongoing chinese translation (<a href="https://github.com/numbbbbb/the-swift-programming-language-in-chinese" target="_blank">https://github.com/numbbbbb/the-swift-programming-language-in-chinese</a>).</div><div><br></div><div>Markdown seem to be a good choice for the actual content, and folder structure for the chapter.</div><div><br></div><div>It will also be a blast to be able to refer to some docs specific part (via GitHub line selection feature) from others online resources (Stack Overflow, ...).</div><div><br></div><div>Happy to kickstart the project if Apple don't want to own it, but still think there is a benefits for the community.</div><div><br></div><div>Cheers,</div><div><br></div><div>Hugues</div><p style="margin-bottom:0px;font-stretch:normal;line-height:normal;font-family:Avenir;min-height:19px"><br></p><p style="margin-bottom:0px;font-stretch:normal;font-size:12px;line-height:normal;font-family:'Sofia Pro Light'">Hugues BERNET-ROLLANDE</p><p style="margin-bottom:0px;font-stretch:normal;font-size:12px;line-height:normal;font-family:'Sofia Pro Light';min-height:16px"><br></p><p style="margin-bottom:0px;font-stretch:normal;font-size:12px;line-height:normal;font-family:'Sofia Pro Light'">--</p><p style="margin-bottom:0px;font-stretch:normal;font-size:12px;line-height:normal;font-family:'Sofia Pro Light'"><a href="mailto:hugues@xdev.fr" target="_blank">hugues@xdev.fr</a></p><p style="margin-bottom:0px;font-stretch:normal;font-size:12px;line-height:normal;font-family:'Sofia Pro Light'"><a href="http://www.xdev.fr" target="_blank">http://www.xdev.fr</a></p><p style="margin-bottom:0px;font-stretch:normal;line-height:normal;font-family:Avenir;min-height:19px">
</p><p style="margin-bottom:0px;font-stretch:normal;font-size:12px;line-height:normal;font-family:'Sofia Pro Light'"><a href="http://www.linkedin.com/in/huguesbr" target="_blank">http://www.linkedin.com/in/huguesbr</a></p></div></div><br></blockquote></div></div><div class="gmail_extra"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">_______________________________________________<br>
swift-evolution mailing list<br>
<a href="mailto:swift-evolution@swift.org" target="_blank">swift-evolution@swift.org</a><br>
<a href="https://lists.swift.org/mailman/listinfo/swift-evolution" rel="noreferrer" target="_blank">https://lists.swift.org/mailman/listinfo/swift-evolution</a><br>
<br></blockquote></div><br></div>
</blockquote></div>