Introduce top navigation (#450)

Co-authored-by: Tomer Doron <tomer@apple.com>
Co-authored-by: Alexander Sandberg <hi@alexandersandberg.com>
Co-authored-by: Mishal Shah <shahmishal@users.noreply.github.com>

Author: 4 people

_data/documentation.yaml

@@ -0,0 +1,82 @@
+- header: Overview
+  pages:
+  - title: Language Reference
+    url: /documentation/tspl/
+    description: |
+      The Swift Programming Language (TSPL) book is the authoritative reference for Swift,
+      offering a guided tour, a comprehensive guide, and a formal reference of the language.
+  - title: API Design Guidelines
+    url: /documentation/api-design-guidelines/
+    description: |
+      Delivering a clear, consistent developer experience when writing Swift code is largely defined by the names and idioms that appear in APIs.
+      These design guidelines explain how to make sure that your code feels like a part of the larger Swift ecosystem
+  - title: Standard Library
+    url: /documentation/standard-library/
+    description: |
+      The Swift standard library defines a base layer of functionality for writing Swift programs.
+  - title: Core Libraries
+    url: /documentation/core-libraries/
+    description: |
+      The Swift Core Libraries project provides higher-level functionality than the Swift standard library.
+      These libraries provide powerful tools that developers can depend upon across all the platforms Swift supports.
+  - title: Package Manager
+    url: /documentation/package-manager/
+    description: |
+      The Swift Package Manager is a tool for managing the distribution and use of "packages" of Swift code.
+      It's integrated with the Swift build system to automate the process of downloading, compiling, and linking dependencies into target products.
+  - title: REPL &  Debugger
+    url: /documentation/lldb/
+    description: |
+      The LLDB debugger provides a rich REPL as well as the debugging environment for the Swift Language.
+  - title: About Swift
+    url: /about/
+    description: |
+      A summary of the core features of Swift, supported platforms, and open source projects.
+#----------------------------------------------------
+- header: Articles
+  pages:
+  - title: Swift on Server
+    url: /documentation/server/
+    description: |
+      Swift is a general-purpose programming language with unique characteristics that make it specifically suitable for Server applications
+  - title: Mixing Swift and C++
+    url: /documentation/cxx-interop/
+    description: |
+      Swift has support for bidirectional interoperability with C++.
+      A great variety of C++ APIs can be called directly from Swift, and select Swift APIs can be used from C++.
+  - title: Value and Reference types
+    url: /documentation/articles/value-and-reference-types
+    description: |
+      Types in Swift are grouped in two categories: value types and reference types.
+      Each behave differently and understanding the difference is an important part of understanding Swift.
+  - title: DocC
+    url: /documentation/docc/
+    description: |
+      DocC is a documentation compiler that makes it easy for you to produce documentation for your Swift frameworks and packages.
+      The compiler builds your documentation by combining the comments you write in source with extension files, articles, and tutorials that live alongside your package's source code.
+#----------------------------------------------------
+- header: Contributing
+  pages:
+  - title: Swift Evolution
+    url: /swift-evolution/
+    description: |
+      Swift evolution governs how changes are introduced to the Swift langague.
+      The process details how ideas are proposed, discussed, reviewed, and eventually accepted into upcoming releases.
+  - title: Source Code
+    url: /documentation/source-code/
+    description: |
+      The code for the Swift project is divided into several open-source repositories, all hosted on GitHub.com.
+  - title: Continuous Integration
+    url: /documentation/continuous-integration/
+    description: |
+      Swift.org CI system produces the snapshot builds posted on swift.org, and runs tests against active branches.
+      It is also used as part of the review process to run tests against pull requests before committing them.
+  - title: Source Compatibility
+    url: /documentation/source-compatibility/
+    description: |
+      Source compatibility test suite is a community owned resource designed to test for regressions
+      in the compiler by building against a corpus of Swift source code.
+  - title: Compiler Architecture
+    url: /documentation/swift-compiler/
+    description: |
+      Overview of the Swift compiler architecture

_data/navigation.yml

@@ -1,179 +1,33 @@
-- pages:
-    - title: About Swift
-      url: /about/
-      sections:
-        - title: Features
-          name: features
-        - title: Swift.org and Open Source
-          name: swiftorg-and-open-source
-        - title: Platform Support
-          name: platform-support
-    - title: Blog
-      url: /blog/
-    - title: Getting Started
-      url: /getting-started/
-      sections:
-        - title: Installing Swift
-          name: installing-swift
-        - title: Using Swift
-          name: using-swift
-        - title: Go Further
-          name: go-further
-    - title: Install
-      url: /install/
-      sections:
-        - title: macOS
-          name: macos
-        - title: Linux
-          name: linux
-        - title: Windows
-          name: windows
-    - title: Download
-      url: /download/
-      sections:
-        - title: Releases
-          name: releases
-        - title: Snapshots
-          name: snapshots
-        - title: Installing Swift
-          name: installing-swift
-    - title: Packages
-      url: /packages/
-      sections:
-        - title: Package Ecosystem
-          name: package-ecosystem
-        - title: Create Your Own
-          name: create-your-own
-        - title: Advanced Search
-          name: advanced-search
-    - title: Platform Support
-      url: /platform-support/
-      sections:
-        - title: Deployment and Development
-          name: deployment-and-development
-        - title: Deployment-only
-          name: deployment-only
-        - title: Platform Owners
-          name: platform-owners
+- header: Get Started
+  url: /getting-started/
+# ------------------------------------------------------------------------------
+- header: Blog
+  url: /blog/
 # ------------------------------------------------------------------------------
 - header: Documentation
+  url: /documentation/
+# ------------------------------------------------------------------------------
+- header: Packages
+  url: /packages/
   pages:
-    - title: Overview
-      url: /documentation/
-      sections:
-        - title: Swift Language
-          name: swift-language
-        - title: Standard Library
-          name: standard-library
-        - title: Packages
-          name: packages
-        - title: API Design Guidelines
-          name: api-design-guidelines
-        - title: C++ Interoperability
-          name: mixing-swift-and-c
-        - title: Tools
-          name: tools
-    - title: Swift Compiler
-      url: /swift-compiler/
-      sections:
-        - title: Compiler Architecture
-          name: compiler-architecture
-    - title: Standard Library
-      url: /standard-library/
-      sections:
-        - title: Standard Library Preview Package
-          name: standard-library-preview-package
-        - title: Standard Library Design
-          name: standard-library-design
-    - title: Package Manager
-      url: /package-manager/
-      sections:
-        - title: Conceptual Overview
-          name: conceptual-overview
-        - title: Example Usage
-          name: example-usage
-    - title: Core Libraries
-      url: /core-libraries/
-      sections:
-        - title: Foundation
-          name: foundation
-        - title: libdispatch
-          name: libdispatch
-        - title: xctest
-          name: xctest
-    - title: REPL, Debugger & Playgrounds
-      url: /lldb/
-      sections:
-        - title: Combined REPL + Debugger
-          name: why-combine-the-repl-and-debugger
-        - title: Xcode Playgrounds
-          name: xcode-playground-support
-    - title: Swift on Server
-      url: /server/
-      sections:
-        - title: Why Swift on Server?
-          name: why-swift-on-server
-        - title: Swift Server Workgroup
-          name: swift-server-workgroup
-        - title: Swift Server Guides
-          name: development-guides
-    - title: Swift Evolution
-      url: /swift-evolution/
-    - title: Source Code
-      url: /source-code/
-      sections:
-        - title: Compiler and Standard Library
-          name: compiler-and-standard-library
-        - title: Core Libraries
-          name: core-libraries
-        - title: Package Manager
-          name: package-manager
-        - title: Xcode Playground Support
-          name: xcode-playground-support
-        - title: Source Tooling
-          name: source-tooling
-        - title: SourceKit-LSP Service
-          name: sourcekit-lsp-service
-        - title: Swift.org Website
-          name: swiftorg-website
-        - title: Cloned Repositories
-          name: cloned-repositories
-    - title: Continuous Integration
-      url: /continuous-integration/
-      sections:
-        - title: Configuration
-          name: configuration
-        - title: Usage
-          name: usage
-        - title: Community Involvement
-          name: community-involvement
-    - title: Source Compatibility
-      url: /source-compatibility/
-      sections:
-        - title: Current List of Projects
-          name: current-list-of-projects
-        - title: Adding Projects
-          name: adding-projects
-        - title: Maintaining Projects
-          name: maintaining-projects
-        - title: Pull Request Testing
-          name: pull-request-testing
-        - title: Building Projects
-          name: building-projects
+    - title: Community Showcase
+      url: /packages/showcase.html
+    - title: Packages with Macros
+      url: /packages/macros.html
+    - title: Server
+      url: /packages/server.html
+    - title: Networking
+      url: /packages/networking.html
+    - title: Testing
+      url: /packages/testing.html
+    - title: Debug Logging
+      url: /packages/logging.html
 # ------------------------------------------------------------------------------
 - header: Community
+  url: /community/
   pages:
-    - title: Overview
-      url: /community/
-      sections:
-        - title: Communication
-          name: communication
-        - title: Community Structure
-          name: community-structure
-        - title: License
-          name: license
-        - title: Forums
-          name: forums
+    - title: Swift Evolution
+      url: /swift-evolution/
     - title: Diversity
       url: /diversity/
       sections:
@@ -217,10 +71,10 @@
           name: adding-external-library-dependencies
         - title: LLVM and Swift
           name: llvm-and-swift
-
-    - title: Contributor Experience Workgroup
+    - section: Workgroups
+    - title: Contributor Experience
       url: /contributor-experience-workgroup/
-    - title: Server Workgroup
+    - title: Server
       url: /sswg/
       sections:
         - title: Community Participation
@@ -229,7 +83,7 @@
           name: governance
         - title: Website workgroup
           name: website-workgroup
-    - title: Website Workgroup
+    - title: Website
       url: /website/
       sections:
         - title: Community Participation
@@ -253,7 +107,7 @@
           name: evolution-process
         - title: Community participation
           name: community-participation
-    - title: C++ Interoperability Workgroup
+    - title: C++ Interoperability
       url: /cxx-interop-workgroup/
       sections:
         - title: Charter
@@ -262,7 +116,7 @@
           name: membership
         - title: Communication
           name: communication
-    - title: Documentation Workgroup
+    - title: Documentation
       url: /documentation-workgroup/
       sections:
         - title: Charter
@@ -273,9 +127,7 @@
           name: communication
         - title: Community Participation
           name: community-participation
-# ------------------------------------------------------------------------------
-- header: Governance
-  pages:
+    - section: Governance
     - title: Code of Conduct
       url: /code-of-conduct/
     - title: License

_includes/getting-started/_installing.md

@@ -4,4 +4,4 @@ If you don't have Swift installed, [install it first](/install).
 
 To test that you have Swift installed, run `swift --version` from your shell or terminal app.
 
-Swift comes bundled with the [Swift Package Manager (SwiftPM)]({% link package-manager/index.md %}), which manages the distribution of your Swift code, and allows easy importing of other Swift packages into your apps.
+Swift comes bundled with the [Swift Package Manager (SwiftPM)]({% link documentation/package-manager/index.md %}), which manages the distribution of your Swift code, and allows easy importing of other Swift packages into your apps.

_includes/logo.html

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xml:space="preserve" viewBox="0 0 191.186 59.391"><path fill="#F05138" d="M59.387 16.45a82.463 82.463 0 0 0-.027-1.792c-.035-1.301-.112-2.614-.343-3.9-.234-1.307-.618-2.523-1.222-3.71a12.464 12.464 0 0 0-5.453-5.452C51.156.992 49.941.609 48.635.374c-1.288-.232-2.6-.308-3.902-.343a85.714 85.714 0 0 0-1.792-.027C42.23 0 41.52 0 40.813 0H18.578c-.71 0-1.419 0-2.128.004-.597.004-1.195.01-1.792.027-.325.009-.651.02-.978.036-.978.047-1.959.133-2.924.307-.98.176-1.908.436-2.811.81A12.503 12.503 0 0 0 3.89 3.89a12.46 12.46 0 0 0-2.294 3.158C.992 8.235.61 9.45.374 10.758c-.231 1.286-.308 2.599-.343 3.9a85.767 85.767 0 0 0-.027 1.792C-.001 17.16 0 17.869 0 18.578v22.235c0 .71 0 1.418.004 2.128.004.597.01 1.194.027 1.791.035 1.302.112 2.615.343 3.901.235 1.307.618 2.523 1.222 3.71a12.457 12.457 0 0 0 5.453 5.453c1.186.603 2.401.986 3.707 1.22 1.287.232 2.6.31 3.902.344.597.016 1.195.023 1.793.027.709.005 1.417.004 2.127.004h22.235c.709 0 1.418 0 2.128-.004.597-.004 1.194-.011 1.792-.027 1.302-.035 2.614-.112 3.902-.343 1.306-.235 2.521-.618 3.707-1.222a12.461 12.461 0 0 0 5.453-5.452c.604-1.187.987-2.403 1.222-3.71.231-1.286.308-2.6.343-3.9.016-.598.023-1.194.027-1.792.004-.71.004-1.419.004-2.129V18.578c0-.71 0-1.419-.004-2.128z"/><path fill="#FFF" d="m47.06 36.66-.004-.004c.066-.224.134-.446.191-.675 2.465-9.821-3.55-21.432-13.731-27.546 4.461 6.048 6.434 13.374 4.681 19.78-.156.571-.344 1.12-.552 1.653-.225-.148-.51-.316-.89-.527 0 0-10.127-6.252-21.103-17.312-.288-.29 5.852 8.777 12.822 16.14-3.284-1.843-12.434-8.5-18.227-13.802.712 1.187 1.558 2.33 2.489 3.43C17.573 23.932 23.882 31.5 31.44 37.314c-5.31 3.25-12.814 3.502-20.285.003a30.646 30.646 0 0 1-5.193-3.098c3.162 5.058 8.033 9.423 13.96 11.97 7.07 3.039 14.1 2.833 19.336.05l-.004.007c.024-.016.055-.032.08-.047.214-.116.428-.234.636-.358 2.516-1.306 7.485-2.63 10.152 2.559.654 1.27 2.041-5.46-3.061-11.74z"/><path id="logotype" d="M81.93 38.542c.465 4.12 4.394 6.822 9.852 6.822 5.185 0 8.924-2.701 8.924-6.44 0-3.22-2.265-5.185-7.478-6.495l-5.048-1.282c-7.26-1.801-10.534-5.077-10.534-10.48 0-6.658 5.813-11.27 14.082-11.27 8.022 0 13.726 4.639 13.917 11.325h-5.32c-.41-4.093-3.74-6.604-8.734-6.604-4.94 0-8.378 2.538-8.378 6.249 0 2.892 2.13 4.612 7.369 5.95l4.202 1.09c8.133 1.993 11.462 5.159 11.462 10.863 0 7.259-5.759 11.816-14.928 11.816-8.514 0-14.327-4.53-14.763-11.543h5.376zM140.049 49.43h-5.35l-6.249-21.776h-.109L122.12 49.43h-5.348l-7.914-28.518h5.184l5.513 22.896h.11l6.221-22.896h5.021l6.277 22.896h.11l5.512-22.896h5.13L140.05 49.43zM151.39 13.244c0-1.718 1.419-3.11 3.138-3.11 1.746 0 3.165 1.392 3.165 3.11 0 1.72-1.419 3.139-3.165 3.139a3.157 3.157 0 0 1-3.139-3.139zm.545 7.669h5.213V49.43h-5.213V20.913zM191.186 25.116v-4.204h-5.513v-6.821h-5.185v6.821h-9.964v-2.51c.027-2.538 1.01-3.603 3.357-3.603.764 0 1.528.083 2.156.192v-4.094a18.193 18.193 0 0 0-2.756-.218c-5.568 0-7.915 2.32-7.915 7.642v2.591h-3.983v4.204h3.983V49.43h5.185V25.116H180.488v16.838c0 5.512 2.101 7.64 7.559 7.64 1.174 0 2.51-.082 3.111-.218v-4.257c-.355.055-1.392.137-1.965.137-2.428 0-3.52-1.147-3.52-3.712V25.116h5.513z"/></svg>