script and data to build the combined collection of docs

.github/workflows/build_documentation.yml

@@ -0,0 +1,41 @@
+name: Build documentation
+
+on:
+  pull_request:
+    types: [opened, reopened, synchronize]
+  push:
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build-docs:
+    name: Build combined documentation
+    runs-on: ubuntu-latest
+    container:
+      image: swiftlang/swift:nightly-main-jammy
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/cache@v4
+        with:
+          path: .workspace
+          key: docs-workspace-${{ hashFiles('scripts/sources.json') }}
+          restore-keys: |
+            docs-workspace-
+
+      - name: Install Python
+        run: apt-get update && apt-get install -y python3
+
+      - name: Build documentation
+        run: python3 scripts/build_docs.py --output-dir "$GITHUB_WORKSPACE/build-output"
+
+      - name: Package build output
+        run: tar -czf "$GITHUB_WORKSPACE/combined-documentation.tar.gz" -C "$GITHUB_WORKSPACE/build-output" .
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: combined-documentation
+          path: combined-documentation.tar.gz

.gitignore

@@ -3,3 +3,8 @@
 .build
 .swiftpm
 Package.resolved
+.build-workspace/
+.workspace/
+.build-output/
+**/*.docc/header.html
+**/*.docc/footer.html

api-guidelines/Sources/APIGuidelines.docc/Documentation.md

@@ -1 +1,5 @@
 # ``APIGuidelines``
+
+@Metadata {
+    @DisplayName("API Guidelines")
+}

common/footer.html

@@ -1,3 +1,12 @@
+<!--
+  This source file is part of the Swift.org open source project
+
+  Copyright (c) 2026 Apple Inc. and the Swift project authors
+  Licensed under Apache License v2.0 with Runtime Library Exception
+
+  See https://swift.org/LICENSE.txt for license information
+  See https://swift.org/CONTRIBUTORS.txt for the list of Swift project authors
+-->
 <style>
 @media all{
 ul,li,h3,p,form,input,legend{margin:0;padding:0;}
@@ -182,7 +191,7 @@ <h3>Governance</h3>
         <div class="copyright">
 
     <p>
-      Copyright © 2025 Apple Inc. All rights reserved.
+      Copyright © 2014–2026 Apple Inc. and the Swift project authors. All rights reserved.
     </p>
     <p>
       Swift and the Swift logo are trademarks of Apple Inc.

common/header.html

@@ -1,3 +1,12 @@
+<!--
+  This source file is part of the Swift.org open source project
+
+  Copyright (c) 2026 Apple Inc. and the Swift project authors
+  Licensed under Apache License v2.0 with Runtime Library Exception
+
+  See https://swift.org/LICENSE.txt for license information
+  See https://swift.org/CONTRIBUTORS.txt for the list of Swift project authors
+-->
 <style>
 @media all{
 ul,li,h1{margin:0;padding:0;}

ecosystem-tools/Sources/EcosystemTools.docc/Documentation.md

@@ -1,2 +1,5 @@
 # ``EcosystemTools``
 
+@Metadata {
+    @DisplayName("Tools and Editors")
+}

language-guides/Sources/LanguageGuides.docc/Documentation.md

@@ -1,2 +1,5 @@
 # ``LanguageGuides``
 
+@Metadata {
+    @DisplayName("Language Guides")
+}