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 &lt;<a href="mailto:cacoyi@gmail.com">cacoyi@gmail.com</a>&gt; 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&#39;m not sure how big a task it is to open source the current system. Hopefully it&#39;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">&lt;<a href="mailto:swift-evolution@swift.org" target="_blank">swift-evolution@swift.org</a>&gt;</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&#39;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:&#39;Sofia Pro Light&#39;">Hugues BERNET-ROLLANDE</p><p style="margin-bottom:0px;font-stretch:normal;font-size:12px;line-height:normal;font-family:&#39;Sofia Pro Light&#39;;min-height:16px"><br></p><p style="margin-bottom:0px;font-stretch:normal;font-size:12px;line-height:normal;font-family:&#39;Sofia Pro Light&#39;">--</p><p style="margin-bottom:0px;font-stretch:normal;font-size:12px;line-height:normal;font-family:&#39;Sofia Pro Light&#39;"><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:&#39;Sofia Pro Light&#39;"><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:&#39;Sofia Pro Light&#39;"><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>