[swift-dev] Separating ./docs into several folders

Michael Gottesman mgottesman at apple.com
Thu Sep 22 21:36:29 CDT 2016


> On Sep 22, 2016, at 6:45 PM, Jacob Bandes-Storch <jtbandes at gmail.com> wrote:
> 
> Can we get swift.org <http://swift.org/> hosted on GitHub Pages, and then make these documents part of the main site? :-)

That is a different topic, no? ; p.

> On Thu, Sep 22, 2016 at 2:59 PM Michael Gottesman via swift-dev <swift-dev at swift.org <mailto:swift-dev at swift.org>> wrote:
> Over time as the project grows, we are going to need more documentation around CI/policy. Right now we just throw both CI/design docs/policy things into ./docs. This makes the docs less organized and less discoverable. My feeling is we would want to separate the docs into:
> 
> ./design - This would include design documentation and the proposals folder. This would include things like the Generics Manifesto.
> ./infrastructure - This would include information about the CI, policy information related to reverting llvm/clang commits
> ./compiler-internals - This would contain documentation of compiler internals. SIL.rst is an example of what this would contain.
> 
> Thoughts?
> 
> Michael
> _______________________________________________
> swift-dev mailing list
> swift-dev at swift.org <mailto:swift-dev at swift.org>
> https://lists.swift.org/mailman/listinfo/swift-dev <https://lists.swift.org/mailman/listinfo/swift-dev>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.swift.org/pipermail/swift-dev/attachments/20160922/e5f7b4f7/attachment.html>


More information about the swift-dev mailing list