Re: Swift using reStructuredText

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 <[email protected]> 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
>

------------------------------------------------------------------------------
Go from Idea to Many App Stores Faster with Intel(R) XDK
Give your users amazing mobile app experiences with Intel(R) XDK.
Use one codebase in this all-in-one HTML5 development environment.
Design, debug & build mobile apps & 2D/3D high-impact games for multiple OSs.
http://pubads.g.doubleclick.net/gampad/clk?id=254741911&iu=/4140