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

Jacob Bandes-Storch jtbandes at gmail.com
Thu Sep 22 20:45:40 CDT 2016


Can we get swift.org hosted on GitHub Pages, and then make these documents
part of the main site? :-)
On Thu, Sep 22, 2016 at 2:59 PM Michael Gottesman via swift-dev <
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
> https://lists.swift.org/mailman/listinfo/swift-dev
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.swift.org/pipermail/swift-dev/attachments/20160923/306d0803/attachment.html>


More information about the swift-dev mailing list