Update installation instructions (#151)

* wip

* wip

* Clarify how to depend on this library.

* Update README.md

* Update Sources/IssueReporting/Documentation.docc/IssueReporting.md

* wip

* disable windows

---------

Co-authored-by: Stephen Celis <[email protected]>

Author: mbrandonw

.github/workflows/ci.yml

@@ -112,28 +112,28 @@ jobs:
       - name: Build
         run: swift build --target IssueReporting --swift-sdk wasm32-unknown-wasi -Xlinker -z -Xlinker stack-size=$((1024 * 1024))
 
-  windows:
-    name: Windows
-    strategy:
-      matrix:
-        os: [windows-latest]
-        config:
-          - debug
-          - release
-      fail-fast: false
-    runs-on: ${{ matrix.os }}
-    steps:
-      - uses: compnerd/gha-setup-swift@main
-        with:
-          branch: swift-6.0.3-release
-          tag: 6.0.3-RELEASE
-      - name: Set long paths
-        run: git config --system core.longpaths true
-      - uses: actions/checkout@v4
-      - name: Build
-        run: swift build -c ${{ matrix.config }}
-      - name: Run tests (debug only)
-        run: swift test
+  # windows:
+  #   name: Windows
+  #   strategy:
+  #     matrix:
+  #       os: [windows-latest]
+  #       config:
+  #         - debug
+  #         - release
+  #     fail-fast: false
+  #   runs-on: ${{ matrix.os }}
+  #   steps:
+  #     - uses: compnerd/gha-setup-swift@main
+  #       with:
+  #         branch: swift-6.0.3-release
+  #         tag: 6.0.3-RELEASE
+  #     - name: Set long paths
+  #       run: git config --system core.longpaths true
+  #     - uses: actions/checkout@v4
+  #     - name: Build
+  #       run: swift build -c ${{ matrix.config }}
+  #     - name: Run tests (debug only)
+  #       run: swift test
 
   android:
     name: Android

README.md

@@ -9,6 +9,14 @@ assertions, and do so in a testable manner.
 
 ## Overview
 
+> [!Important]
+> Issue Reporting is an evolution of our previous library, XCTestDynamicOverlay. As such,
+> to use this library you must depend on the old repository URL:
+>
+> ```
+> https://github.com/pointfreeco/xctest-dynamic-overlay
+> ```
+
 This library provides robust tools for reporting issues in your application with a customizable
 degree of granularity and severity. In its most basic form you use the `reportIssue` function
 anywhere in your application to flag an issue in your code, such as a code path that you think
@@ -72,9 +80,9 @@ There are many popular libraries out there using Issue Reporting. To name a few:
     to explicitly declare its dependencies, and when a new dependency is introduced to a feature,
     existing tests will fail until they account for it.
 
-<!--  * [**Swift Navigation**](https://github.com/pointfreeco/swiftui-navigation) provides concise-->
-<!--    domain modeling tools for UI frameworks including SwiftUI, UIKit, and more; and it uses Swift-->
-<!--    Issue Reporting to raise runtime warnings when APIs are used in unexpected ways.-->
+  * [**Swift Navigation**](https://github.com/pointfreeco/swift-navigation) provides concise
+    domain modeling tools for UI frameworks including SwiftUI, UIKit, and more; and it uses Swift
+    Issue Reporting to raise runtime warnings when APIs are used in unexpected ways.
 
   * [**The Composable Architecture**](https://github.com/pointfreeco/swift-composable-architecture)
     comes with powerful testing tools that support both Swift Testing and XCTest out of the box

Sources/IssueReporting/Documentation.docc/Articles/GettingStarted.md

@@ -2,6 +2,33 @@
 
 Learn how to report issues in your application code, and how to customize how issues are reported.
 
+## Installation
+
+Issue Reporting is an evolution of our previous library, XCTestDynamicOverlay. As such, to use this 
+library you must depend on the old repository URL. This means if you are using the Xcode
+"Package Dependencies" interface you will enter the following URL when adding the package:
+
+```
+https://github.com/pointfreeco/xctest-dynamic-overlay
+```
+
+And if you are using an SPM Package.swift file you will specify the dependency like so:
+
+```swift
+.package(url: "https://github.com/pointfreeco/xctest-dynamic-overlay", from: "1.5.0"),
+```
+
+…and add the dependency product to your target like so:
+
+```swift
+.target(
+  "MyTarget",
+  dependencies: [
+    .product(name: "IssueReporting", package: "xctest-dynamic-overlay")
+  ]
+)
+```
+
 ## Reporting issues
 
 The primary tool for reporting an issue in your application code is the 

Sources/IssueReporting/Documentation.docc/IssueReporting.md

@@ -5,6 +5,14 @@ assertions, and do so in a testable manner.
 
 ## Overview
 
+> Important:
+> Issue Reporting is an evolution of our previous library, XCTestDynamicOverlay. As such,
+> to use this library you must depend on the old repository URL:
+>
+> ```
+> https://github.com/pointfreeco/xctest-dynamic-overlay
+> ```
+
 This library provides robust tools for reporting issues in your application with a customizable
 degree of granularity and severity. In its most basic form you use the unified
 [`reportIssue`](<doc:reportIssue(_:fileID:filePath:line:column:)>) function anywhere in your