Address Copilot PR review feedback (#22)

- Correct Peripheral init docs to point at discoveredPeripherals publisher
- Write DocC output to ./docc-output via --output-path instead of .build plugin path
- Add Xcode 16.4 existence check with installed-version diagnostics
- Ignore docc-output/ build directory

Author: itsniper

.github/workflows/ci.yml

@@ -18,20 +18,29 @@ jobs:
       - uses: actions/checkout@v4
 
       - name: Select Xcode
-        run: sudo xcode-select -s /Applications/Xcode_16.4.app/Contents/Developer
+        run: |
+          if [ ! -d /Applications/Xcode_16.4.app ]; then
+            echo "Xcode 16.4 not found. Installed Xcode versions:"
+            ls /Applications | grep Xcode || true
+            exit 1
+          fi
+          sudo xcode-select -s /Applications/Xcode_16.4.app/Contents/Developer
 
       - name: Verify Swift version
         run: swift --version
 
       - name: Build DocC catalog
-        run: swift package generate-documentation --target ReliaBLE --warnings-as-errors
+        run: |
+          swift package --allow-writing-to-directory ./docc-output \
+            generate-documentation --target ReliaBLE --warnings-as-errors \
+            --output-path ./docc-output
 
       - name: Archive DocC output
-        run: ditto -c -k --sequesterRsrc --keepParent .build/plugins/Swift-DocC/outputs/ReliaBLE.doccarchive ReliaBLE.doccarchive.zip
+        run: ditto -c -k --sequesterRsrc --keepParent docc-output ReliaBLE-docs.zip
 
       - name: Upload DocC archive
         uses: actions/upload-artifact@v4
         with:
-          name: ReliaBLE.doccarchive
-          path: ReliaBLE.doccarchive.zip
+          name: ReliaBLE-docs
+          path: ReliaBLE-docs.zip
           if-no-files-found: error

.gitignore

@@ -33,6 +33,7 @@ Packages/
 .swiftpm
 
 .build/
+docc-output/
 DerivedData/
 
 # CocoaPods

Sources/ReliaBLE/Models/Peripheral.swift

@@ -66,10 +66,10 @@ public class Peripheral: Identifiable, Hashable {
     /// The timestamp when the peripheral was last seen
     public internal(set) var lastSeen: Date?
 
-    /// Create a peripheral with a unique identifier and optional CoreBluetooth peripheral data. The integrating app
-    /// should use this initializer to create a `Peripheral` instance when it has a unique identifier for a peripheral
-    /// but has not yet discovered the peripheral with CoreBluetooth. ReliaBLE will update the instance
-    /// with CoreBluetooth data when the peripheral is discovered.
+    /// Creates a peripheral with a unique identifier and optional CoreBluetooth discovery data.
+    ///
+    /// Prefer observing ``ReliaBLEManager/discoveredPeripherals`` for devices discovered during scanning.
+    /// ReliaBLE updates only the ``Peripheral`` instances it manages internally and emits through that publisher.
     /// - Parameters:
     ///  - id: Unique identifier for the peripheral as set by the integrating app.
     ///  - peripheral: Reference to the CoreBluetooth `CBPeripheral` object