Re: [Docutils-users] Swift using reStructuredText

[Tony N. <to...@gi...>]

Unfortunately, it seems they will be moving to markdown for unspecified
reasons. Apparently they already made up their mind internally.

https://lists.swift.org/pipermail/swift-dev/2015-December/000047.html
https://github.com/apple/swift/pull/246

A bit more detail was added later:

"(Why GitHub-Flavored Markdown? Because most likely the most common way to
view them will be on GitHub. If we can also get Kramdown compatibility
that's great, because that's what our website uses, but that's just a
bonus.)"

Source: https://github.com/apple/swift/pull/246#issuecomment-162233091

It's hard to beat the feature set of sphinx, but there are some nice
systems out there popping up we can learn from.

On Sat, Dec 5, 2015 at 12:24 PM, Tony Narlock <to...@gi...> wrote:

> Greetings Docutils Users,
>
> I'm pleased to let you know, Apple's Swift project joins CoreCLR, LLVM,
> CMake and other projects to use reStructuredText for their documentation.
>
> https://github.com/apple/swift/tree/master/docs
>
> Take note of how the project uses CMakeLists.txt for creating the sphinx
> Makefile: https://github.com/apple/swift/blob/master/docs/CMakeLists.txt
>