Documentation clean up (#144)

- Hides documentation without content
- Tweaks experimental notices

Author: kubamracek

Sources/EmbeddedSwift/Documentation.docc/BuildSystemSupport/IntegrateWithBazel.md renamed to Sources/EmbeddedSwift/Documentation.docc/BuildSystemSupport/IntegrateWithBazel.md-wip

@@ -1,9 +1,9 @@
-# ``EmbeddedSwift``
+# Embedded Swift
 
 Embedded Swift is a compilation and language mode that enables development of baremetal, embedded and standalone software in Swift
 
 @Metadata {
-  @DisplayName("Embedded Swift")
+  @TechnologyRoot
 }
 
 ## Topics

Sources/EmbeddedSwift/Documentation.docc/BuildSystemSupport/IntegrateWithCMake.md renamed to Sources/EmbeddedSwift/Documentation.docc/BuildSystemSupport/IntegrateWithCMake.md-wip

@@ -4,9 +4,9 @@ Get the tools needed to use Embedded Swift
 
 ## Overview
 
-> Warning: Embedded Swift is experimental. Use the latest downloadable 'Trunk Development' snapshot from swift.org to use Embedded Swift. Public releases of Swift do not yet support Embedded Swift.
+The best way to install Swift for embedded development is using [`swiftly`](http://github.com/swiftlang/swiftly), the official Swift toolchain installer and manager. Since Embedded Swift is still experimental and not yet supported in public Swift releases, you'll need to use a development toolchain.
 
-The best way to install Swift is using [`swiftly`](http://github.com/swiftlang/swiftly), the official Swift toolchain installer and manager. For instructions on how to install `swiftly`, check out the [Getting Started](https://www.swift.org/swiftly/documentation/swiftly/getting-started) guide.
+For instructions on how to install `swiftly`, check out the [Getting Started](https://www.swift.org/swiftly/documentation/swiftly/getting-started) guide.
 
 > Note: Swiftly installs the latest release toolchain during `swiftly init`, if you only plan on using Embedded Swift, you can avoid downloading this toolchain by using the `swiftly init --skip-install` option. 
 

Sources/EmbeddedSwift/Documentation.docc/BuildSystemSupport/IntegrateWithMake.md renamed to Sources/EmbeddedSwift/Documentation.docc/BuildSystemSupport/IntegrateWithMake.md-wip

@@ -6,7 +6,7 @@ Write Swift code for microcontrollers, embedded systems, and bare-metal applicat
 
 Embedded Swift is an experimental and rapidly developing feature of the Swift language that enables development of baremetal, embedded and standalone software. It's a subset of the Swift language designed for producing small, efficient binaries with minimal dependencies, making it suitable for resource-constrained environments.
 
-> Warning: Embedded Swift is experimental. Use the latest downloadable 'Trunk Development' snapshot from swift.org to use Embedded Swift. Public releases of Swift do not yet support Embedded Swift.
+> Note: Embedded Swift is experimental. Public releases of Swift do not support Embedded Swift, yet. See <doc:InstallEmbeddedSwift> for details.
 
 ## How does Embedded Swift differ from regular Swift?
 

Sources/EmbeddedSwift/Documentation.docc/BuildSystemSupport/IntegrateWithSwiftPM.md renamed to Sources/EmbeddedSwift/Documentation.docc/BuildSystemSupport/IntegrateWithSwiftPM.md-wip

@@ -4,8 +4,6 @@ Possible directions to explore to start using Embedded Swift
 
 ## Introduction
 
-> Warning: Embedded Swift is experimental. Use the latest downloadable 'Trunk Development' snapshot from swift.org to use Embedded Swift. Public releases of Swift do not yet support Embedded Swift.
-
 Embedded Swift is a way to write code for embedded systems using the Swift programming language. Depending on the use case, there are different ways of using it, different ways of integrating with existing ecosystems, and different setups for different hardware devices. This guide will help you explore various paths to get started with embedded development using Swift.
 
 Before diving into Embedded Swift development, you should have:
@@ -14,6 +12,8 @@ Before diving into Embedded Swift development, you should have:
 - A Swift toolchain installed on your development host
 - A target embedded platform in mind (e.g. a Raspberry Pi Pico)
   - this can also be a simulated hardware platform (e.g. in QEMU), or even a full desktop OS environment in case you're not interested in controlling low-level hardware or custom electronic peripherals
+  
+> Note: Embedded Swift is experimental. Public releases of Swift do not support Embedded Swift, yet. See <doc:InstallEmbeddedSwift> for details.
 
 ## Guided Tutorials
 

Sources/EmbeddedSwift/Documentation.docc/BuildSystemSupport/IntegrateWithXcode.md renamed to Sources/EmbeddedSwift/Documentation.docc/BuildSystemSupport/IntegrateWithXcode.md-wip

@@ -6,7 +6,7 @@ In this guide we'll be targeting a Raspberry Pi Pico as the embedded device that
 
 ## Installing Swift
 
-> Warning: Embedded Swift is experimental. Use the latest downloadable 'Trunk Development' snapshot from swift.org to use Embedded Swift. Public releases of Swift do not yet support Embedded Swift.
+> Note: Embedded Swift is experimental. Public releases of Swift do not support Embedded Swift, yet. See <doc:InstallEmbeddedSwift> for details.
 
 To install Swift for embedded development, follow the instructions in <doc:InstallEmbeddedSwift>, which guides you through using `swiftly` to install the latest development snapshot with Embedded Swift support.
 

Sources/EmbeddedSwift/Documentation.docc/Documentation.md

@@ -2,7 +2,7 @@
 
 Setting up a project that can seamlessly use C APIs from the Pico SDK.
 
-> Warning: Embedded Swift is experimental. Use the latest downloadable 'Trunk Development' snapshot from swift.org to use Embedded Swift. Public releases of Swift do not yet support Embedded Swift.
+> Note: Embedded Swift is experimental. Public releases of Swift do not support Embedded Swift, yet. See <doc:InstallEmbeddedSwift> for details.
 
 Development for [Raspberry Pi Pico and Pico W](https://www.raspberrypi.com/products/raspberry-pi-pico/) normally uses the [Pico SDK](https://github.com/raspberrypi/pico-sdk) and the vendor provides several [sample projects in the pico-examples repository](https://github.com/raspberrypi/pico-examples). The SDK and sample project setup is described in:
 

Sources/EmbeddedSwift/Documentation.docc/GettingStarted/InstallEmbeddedSwift.md

@@ -1,10 +1,10 @@
 # Integrating with Zephyr
 
-**⚠️ Embedded Swift is experimental. This document might be out of date with latest development.**
+Integrating Swift with Zephyr RTOS for embedded systems development
 
-For an introduction and motivation into Embedded Swift, please see "[A Vision for Embedded Swift](https://github.com/swiftlang/swift-evolution/blob/main/visions/embedded-swift.md)", a Swift Evolution document highlighting the main goals and approaches.
+The following document outlines how to setup a Swift to Zephyr project for an emulated ARM Cortex M0, explaining a few key concepts along the way. For a complete working example on real hardware, however, refer to the [nrfx-blink-sdk](https://github.com/apple/swift-embedded-examples/tree/main/nrfx-blink-sdk) project that is compatible with nRF or other boards.
 
-The following document outlines how to setup a Swift to Zephyr project for an emulated ARM Cortex M0, explaining a few key concepts along the way. For a complete working example on real hardware, however, refer to the [nrfx-blink-sdk](../../../../nrfx-blink-sdk/) project that is compatible with nRF or other boards.
+> Note: Embedded Swift is experimental. Public releases of Swift do not support Embedded Swift, yet. See <doc:InstallEmbeddedSwift> for details.
 
 ## Zephyr Target Architecture Compatibility