Alex Martini

For example, here's the syntax outline used to illustrate the syntax of a `for` loop: ``` for in { } ``` The current TSPL pipeline styles them as blue bubbles,...

@swift-ci Please test.

Transferred to the TSPL repo and re-opened.

As of https://github.com/apple/swift-docc/pull/368 we can now disable the automatic see-also and customize the "eyebrow" title. Automatic pagination looks like that's still future DocC work.

I made a branch to try out the new DocC directives. Looks like we probably want to wait for `@GlobalOptions` to be implemented too, so we don't have to write...

See also https://github.com/apple/swift-docc/issues/354, which likely requires much of the same underlying work in DocC.

The comments in the markdown that show the version of a code listing that was tested under the RST-based pipeline have a marker at the start of each that tells...

For an example of the kinds of mistakes that tested code listings prevents, see . In that case, I had to write some code listings without tests, because the "swifttest"...

The current book's approach to styling the grammar tries to be as easy to read as possible — even when that makes it a little more difficult to author, compared...

Filed https://github.com/apple/swift-book/issues/48 to track navigation separately as a "parity" issue. One approach we could take using the markup currently available in DocC is to use note boxes. - Use a...