Alex Martini

Results 72 comments of Alex Martini

You're correct — the documentation hasn't been updated for SE-0155. That work was delayed because of the way the compiler implementation landed in smaller pieces, which made it hard to...

@dabrahams Thanks for the feedback. Are you suggesting that the return type of the function should be `Collection` instead of `some Collection`? If so, we need to find a different...

Fixed for chapters by https://github.com/apple/swift-book/pull/100, which also contains a proof of concept for section redirects.

@flbn The url `https://docs.swift.org/documentation/swift-book` is the URL I originally expected to use. DocC has limitations on URLs, so we ended up publishing at `https://docs.swift.org/swift-book/documentation/the-swift-programming-language/` instead. If you see links to...

With the changes from #109 about 1/4 of the redirects still need to be manually filled in. Here's the process I've used to create those entries: 1. Check out commit...

@nakul1710 Please feel free to make a pull request against DocC to add support for this behavior, and then open a pull request against TSPL to adopt the new behavior....

@nakul1710 Please see my comments from May 19 [above](https://github.com/apple/swift-book/issues/117#issuecomment-1555175718). I suggest you make a PR with your suggested changes in the Swift-DocC repository, and in this repository.

The following comments are from Susan (one of our editors), who reviewed this PR today. The punctuation/wording, etc is fine, except for these few instances where colons are needed below:...

~~To add a index, we need the ability in DocC to link to a specific place on a page and not just to the nearest heading. That's also what we...

Sorry — that cross reference was poorly phrased. The bug in Radar is tracking essentially the same request as this GitHub issue. I'm mostly adding the cross reference myself in...