Check for broken links in the CI test job

CONTRIBUTORS.md

@@ -1,7 +1,11 @@
 ---
 layout: page
 title: Swift Contributors
-permalink: /CONTRIBUTORS
+
+# Weirdly, CONTRIBUTORS.md is getting rendered as CONTROBUTORS.html.
+# That permalink setting, though, is getting rendered in it's rel=canonical,
+# and we don't want it to be broken.
+permalink: /CONTRIBUTORS.html
 ---
 
 {% include_relative CONTRIBUTORS.txt %}

Gemfile

@@ -4,4 +4,8 @@ source 'https://rubygems.org'
 gem 'jekyll', '~> 4.2.1'
 gem 'jekyll-redirect-from'
 
+# html-proofer checks for broken links.
+# used in docker-compose.yml test job
+gem 'html-proofer'
+
 gem "webrick", "~> 1.7"

Gemfile.lock

@@ -1,19 +1,44 @@
 GEM
   remote: https://rubygems.org/
   specs:
+    Ascii85 (1.1.0)
     addressable (2.8.0)
       public_suffix (>= 2.0.2, < 5.0)
+    afm (0.2.2)
+    async (2.6.4)
+      console (~> 1.10)
+      fiber-annotation
+      io-event (~> 1.1)
+      timers (~> 4.1)
     colorator (1.1.0)
     concurrent-ruby (1.1.10)
+    console (1.23.2)
+      fiber-annotation
+      fiber-local
     em-websocket (0.5.3)
       eventmachine (>= 0.12.9)
       http_parser.rb (~> 0)
+    ethon (0.16.0)
+      ffi (>= 1.15.0)
     eventmachine (1.2.7)
     ffi (1.15.5)
+    fiber-annotation (0.2.0)
+    fiber-local (1.0.0)
     forwardable-extended (2.6.0)
+    hashery (2.1.2)
+    html-proofer (5.0.8)
+      addressable (~> 2.3)
+      async (~> 2.1)
+      nokogiri (~> 1.13)
+      pdf-reader (~> 2.11)
+      rainbow (~> 3.0)
+      typhoeus (~> 1.3)
+      yell (~> 2.0)
+      zeitwerk (~> 2.5)
     http_parser.rb (0.8.0)
     i18n (1.10.0)
       concurrent-ruby (~> 1.0)
+    io-event (1.3.2)
     jekyll (4.2.2)
       addressable (~> 2.4)
       colorator (~> 1.0)
@@ -44,26 +69,44 @@ GEM
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
     mercenary (0.4.0)
+    nokogiri (1.15.4-arm64-darwin)
+      racc (~> 1.4)
     pathutil (0.16.2)
       forwardable-extended (~> 2.6)
+    pdf-reader (2.11.0)
+      Ascii85 (~> 1.0)
+      afm (~> 0.2.1)
+      hashery (~> 2.0)
+      ruby-rc4
+      ttfunk
     public_suffix (4.0.7)
+    racc (1.7.1)
+    rainbow (3.1.1)
     rb-fsevent (0.11.1)
     rb-inotify (0.10.1)
       ffi (~> 1.0)
     rexml (3.2.5)
     rouge (3.28.0)
+    ruby-rc4 (0.1.5)
     safe_yaml (1.0.5)
     sassc (2.4.0)
       ffi (~> 1.9)
     terminal-table (2.0.0)
       unicode-display_width (~> 1.1, >= 1.1.1)
+    timers (4.3.5)
+    ttfunk (1.7.0)
+    typhoeus (1.4.0)
+      ethon (>= 0.9.0)
     unicode-display_width (1.8.0)
     webrick (1.7.0)
+    yell (2.2.2)
+    zeitwerk (2.6.11)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
+  html-proofer
   jekyll (~> 4.2.1)
   jekyll-redirect-from
   webrick (~> 1.7)

_data/go_further.yml

@@ -3,27 +3,32 @@
   content_type: article
   content_url: /documentation/articles/value-and-reference-types.html
   thumbnail_url: #TBD
+  thumbnail_alt:
   release_date: 2023-04-29
   external: false
 - title: "Generics"
   description: "In Swift, generics are a fundamental way to write abstract code. This video walks through the basics of Swift Generics and introducing generics into your code."
   content_type: video
   content_url: https://developer.apple.com/videos/play/wwdc2022/110352/
   thumbnail_url: /assets/images/getting-started/swift-generics-thumbnail.jpg
+  thumbnail_alt: "A block thumbnail image with three emoji icons: a femail farmer, a cow, and a carrot."
   release_date: 2021-06-09
   external: true
 - title: "Concurrency"
   description: "Swift has concurrency features built into the language making it easier to write concurrent code with the assistance of the compiler. This video introduces the async/await mechanism, a key part of Swift Concurrency."
   content_type: video
   content_url: https://developer.apple.com/videos/play/wwdc2021/10132/
   thumbnail_url: /assets/images/getting-started/meet-async-await-thumbnail.jpg
+  thumbnail_alt: |
+    A thumbnail image describing a concurrent sequence diagram with five blocks: green into yellow into purple into another yello into another green.
   release_date: 2021-06-08
   external: true
 - title: "Regular Expressions"
   description: "Swift provides first-class regular expression support, commonly known as regex, for effective string processing. This video gives an overview of the power and flexibility of Swift Regex."
   content_type: video
   content_url: https://developer.apple.com/videos/play/wwdc2022/110357/
   thumbnail_url: /assets/images/getting-started/regular-expression-thumbnail.jpg
+  thumbnail_alt: "An image describing a block of code about Regular Expression syntax."
   release_date: 2022-06-07
   external: true
 

_data/navigation.yml

@@ -199,7 +199,7 @@
         - title: Blog Post Contributions
           name: website-and-blog-post-contributions
         - title: Swift Evolution
-          name: evolution-process
+          name: swift-evolution
         - title: Good First Issues
           name: good-first-issues
         - title: Contributing Code

_includes/footer.html

@@ -4,8 +4,8 @@
     <p class="copyright">Copyright © {{ site.time | date: '%Y' }} Apple Inc. All rights reserved.</p>
     <p class="trademark">Swift and the Swift logo are trademarks of Apple Inc.</p>
     <p class="privacy">
-      <a href="//www.apple.com/privacy/privacy-policy/">Privacy Policy</a>
-      <a href="//www.apple.com/legal/privacy/en-ww/cookies/">Cookies</a>
+      <a href="https://www.apple.com/privacy/privacy-policy/">Privacy Policy</a>
+      <a href="https://www.apple.com/legal/privacy/en-ww/cookies/">Cookies</a>
     </p>
   </div>
   <div class="footer-other">

_posts/2015-12-03-swift-3-api-design.md

@@ -73,5 +73,5 @@ list](/community/#swift-evolution).
 [clang-importer-proposal]: https://github.com/apple/swift-evolution/blob/master/proposals/0005-objective-c-name-translation.md  "Better Translation of Objective-C APIs into Swift proposal"
 [swift-3-api-guidelines-repo]: https://github.com/apple/swift-3-api-guidelines-review  "Swift 3 API Design Guidelines review repository"
 [objc-cocoa-guidelines]: https://developer.apple.com/library/content/documentation/Cocoa/Conceptual/CodingGuidelines/CodingGuidelines.html  "Objective-C Coding Guidelines for Cocoa"
-[swift-evolution]: /contributing/#evolution-process  "Swift evolution process"
+[swift-evolution]: /contributing/#swift-evolution  "Swift evolution process"
 [core-libraries]: /core-libraries  "Swift core libraries"

_posts/2015-12-03-welcome.md

@@ -40,7 +40,7 @@ This website is the home of the Swift project with links to the resources you wi
 * The [Swift mailing lists](/community/#mailing-lists) are how we interact
 * The [Getting Started](/getting-started/) pages will help you setup a Swift development environment
 * The [Download](/download/) page includes pre-built binaries for the supported platforms
-* The [Swift Evolution Process](/contributing/#evolution-process) describes how new features are proposed
+* The [Swift Evolution Process](/contributing/#swift-evolution) describes how new features are proposed
 
 
 Welcome to the open source Swift community.

_posts/2016-03-21-swift-2.2-released.md

@@ -38,7 +38,7 @@ Official binaries for Ubuntu 14.04 and Ubuntu 15.10 are [available for download]
 
 #### Apple (Xcode)
 
-For development on Apple's platforms, Swift 2.2 ships as part of [Xcode 7.3](https://developer.apple.com/xcode/download/).
+For development on Apple's platforms, Swift 2.2 ships as part of [Xcode 7.3](https://developer.apple.com/download/all/?q=xcode).
 
 ### Sources
 

_posts/2021-02-22-black-history-month.md

@@ -13,7 +13,7 @@ There are many Black developers in the Swift community creating educational reso
 
 ## Pushing Swift in new directions
 
-[Marc Aupont](https://twitter.com/digimarktech) is pushing the boundaries of the Swift ecosystem by using Swift in embedded systems. Learn about how Marc built a robot car using a Raspberry Pi running Swift in his talk from try! Swift NYC 2019: [Swift Without Screens - Powering Connected Devices](https://www.youtube.com/watch?v=VILUaec-sCs). Marc goes into greater detail on writing Swift code for Raspberry Pi in the iPhreaks podcast episode: [iPS 296: Swift on Raspberry PI](https://devchat.tv/iphreaks/ips-296-swift-on-raspberry-pi-with-marc-aupont/).
+[Marc Aupont](https://twitter.com/digimarktech) is pushing the boundaries of the Swift ecosystem by using Swift in embedded systems. Learn about how Marc built a robot car using a Raspberry Pi running Swift in his talk from try! Swift NYC 2019: [Swift Without Screens - Powering Connected Devices](https://www.youtube.com/watch?v=VILUaec-sCs). Marc goes into greater detail on writing Swift code for Raspberry Pi in the iPhreaks podcast episode: [iPS 296: Swift on Raspberry PI](https://podcasts.apple.com/pl/podcast/ips-296-swift-on-raspberry-pi-with-marc-aupont/id634022060?i=1000480314894).
 
 [Ish ShaBazz](https://twitter.com/ishabazz) is presenting the Swift community with a different perspective by emphasizing the human side of programming. In his powerful talk from SwiftFest Boston 2019, [Programming with a Purpose](https://www.youtube.com/watch?v=M-7DQJbMapI&feature=youtu.be), Ish tells his inspirational story of how he discovered his purpose, and the valuable lessons he learned along the way, including conquering imposter syndrome with curiosity, and overcoming fear in programming, public speaking, and life.
 
@@ -25,4 +25,4 @@ To help young readers discover books written by and featuring people of color, [
 
 ## Join in on the celebration!
 
-We are grateful for the perspectives, resources, and innovation that the Black community has brought to Swift. Please join in on the Black History Month celebration over on the [Community Showcase forum](https://forums.swift.org/c/community-showcase/) and share how the Black community has made a positive impact on your journey with Swift. If you are a member of the Black Swift community, we highly encourage you to [join Black in Swift](/diversity/#community-groups) to connect with others in the community!
+We are grateful for the perspectives, resources, and innovation that the Black community has brought to Swift. Please join in on the Black History Month celebration over on the [Community Showcase forum](https://forums.swift.org/c/community-showcase/) and share how the Black community has made a positive impact on your journey with Swift. If you are a member of the Black Swift community, we highly encourage you to [join Black in Swift](/diversity/#community-groups) to connect with others in the community!

_posts/2023-03-30-swift-5.8-released.md

@@ -6,7 +6,7 @@ title: Swift 5.8 Released!
 author: [alexandersandberg]
 ---
 
-Swift 5.8 is now officially released! 🎉 This release includes major additions to the [language and standard library](#language-and-standard-library), including `hasFeature` to support piecemeal adoption of upcoming features, an improved [developer experience](#developer-experience), improvements to tools in the Swift ecosystem including [Swift-DocC](#swift-docc), [Swift Package Manager](#swift-package-manager), and [SwiftSyntax](#swiftsyntax), refined [Windows support](#windows-platform), and more.
+Swift 5.8 is now officially released! 🎉 This release includes major additions to the [language and standard library]({% link _posts/2023-03-30-swift-5.8-released.md%}#language-and-standard-library), including `hasFeature` to support piecemeal adoption of upcoming features, an improved [developer experience](#developer-experience), improvements to tools in the Swift ecosystem including [Swift-DocC](#swift-docc), [Swift Package Manager](#swift-package-manager), and [SwiftSyntax](#swiftsyntax), refined [Windows support](#windows-platform), and more.
 
 Thank you to everyone in the Swift community who made this release possible. Your Swift Forums discussions, bug reports, pull requests, educational content, and other contributions are always appreciated!
 

community/index.md

@@ -59,7 +59,7 @@ The current Core Team members are:
 
 [Contact via Forums](https://forums.swift.org/new-message?groupname=language-workgroup)
 
-The Language Steering Group comprises experts that the Swift Project Lead and the Core Team have identified as possessing a balance of perspectives and expertise to review, guide, and strategically align changes to the language mindfully.  The Language Steering Group reviews and helps iterate [language evolution proposals](/contributing/#evolution-process) from the community, acting as the approver of these proposals.  Workgroup members help drive the Swift language forward coherently to create the best possible general-purpose programming language.  The Language Steering Group membership is expected to change over time.
+The Language Steering Group comprises experts that the Swift Project Lead and the Core Team have identified as possessing a balance of perspectives and expertise to review, guide, and strategically align changes to the language mindfully.  The Language Steering Group reviews and helps iterate [language evolution proposals](/contributing/#swift-evolution) from the community, acting as the approver of these proposals.  Workgroup members help drive the Swift language forward coherently to create the best possible general-purpose programming language.  The Language Steering Group membership is expected to change over time.
 
 The current Language Steering Group members are:
 

contributing/_swift-evolution-process.md

@@ -1,5 +1,3 @@
-<a name="evolution-process"></a>
-
 ## Swift Evolution
 
 Shaping the future of Swift is a community effort that anyone can participate in via the [Evolution section of the Swift forums][swift-evolution-forums].

docker-compose.yaml

@@ -45,6 +45,14 @@ services:
         && bundle exec jekyll doctor --source /srv/jekyll --destination /output
         && bundle exec jekyll build --source /srv/jekyll --destination /output"
 
+   check-links:
+      <<: *common
+      command: /bin/bash -cl "/code/scripts/check_links.sh"
+      volumes:
+         - .:/srv/jekyll:cached
+         - ./.output:/output:z
+         - .:/code:z
+
    website:
      <<: *common
      command: /bin/bash -cl "bundle check && bundle exec jekyll serve --source /srv/jekyll --destination /output --host 0.0.0.0 --watch"