Add remaining redirects from the old section/subsection URLs about swift-book HOT 5 OPEN

Fixed for chapters by #100, which also contains a proof of concept for section redirects.

from swift-book.

is this still open? repo links to https://docs.swift.org/swift-book/, which redirects to https://docs.swift.org/swift-book/documentation/the-swift-programming-language/ as opposed to the https://docs.swift.org/documentation/swift-book link mentioned above (which results in a 404)

from swift-book.

@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 https://docs.swift.org/swift-book/ in a Swift project, please either open an issue or a PR to update the link. I'm not sure which place you mean by "repo".

This issue is still open, tracking the second issue in its description — redirection of links to sections.

from swift-book.

:0 sounds good, here's a quick PR: #113

from swift-book.

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 94646f9 in a separate directory, which was the last RST version of the book.
2. Identify a missing redirect in bin/redirects/redirect.swift by searching for docc: "" (an empty string).
3. Do a case-insensitive search for that line's sphinx parameter in the RST source, replacing - with _ in the search term.
4. If there's a search match, it will be right before the heading. Use the filename and the text of the heading to construct a DocC link, and write it in the docc parameter.
5. If there are no matches, use git log -S or git log -G to find the commit where the Spinx writer-specified ID was changed, and repeat the search using the new name. Or, if the section was deleted, try to pick a fallback heading that contains the same content.

from swift-book.