Another attempt at posting docs

Makefile

@@ -11,15 +11,16 @@ clean:
  rm -rf "$(PWD)/.DerivedData-macos" "$(PWD)/.DerivedData-ios" "$(PWD)/.DerivedData-tvos" "$(SPM_WORKSPACE)"
 
 docc:
+ xcodebuild docbuild \
+ -workspace "$(WORKSPACE)" \
+ $(QUIET) \
+ -scheme "JoyStickView" \
+ -destination platform="$(PLATFORM_IOS)" \
+ -derivedDataPath "$(PWD)/.DerivedData-ios"
  DOCC_JSON_PRETTYPRINT="YES" \
- swift package \
- --allow-writing-to-directory "$(DOCC_DIR)" \
- generate-documentation \
- --target JoyStickView \
- --disable-indexing \
- --transform-for-static-hosting \
- --hosting-base-path Joystick \
- --output-path "$(DOCC_DIR)"
+ xcrun docc process-archive transform-for-static-hosting `find $(PWD)/.DerivedData-ios -type d -name *.doccarchive` \
+ --hosting-base-path JoystickView \
+ --output-path docs
 
 lint: clean
  @if command -v swiftlint; then swiftlint; fi

Package.swift

@@ -25,3 +25,10 @@ let package = Package(
  )
  ]
 )
+
+#if swift(>=5.6)
+// Add the documentation compiler plugin if possible
+package.dependencies.append(
+ .package(url: "https://github.com/apple/swift-docc-plugin", from: "1.3.0")
+)
+#endif

Sources/JoyStickView/JoyStickView.swift

@@ -47,7 +47,7 @@ import CoreGraphics
  }
 
  /// The last-reported angle from the joystick handle. Unit is degrees, with 0° up (north) and 90° right (east).
- /// Note that this assumes that ``angleRadians`` was calculated with atan2(dx, dy) and that dy is positive when
+ /// Note that this assumes that `angleRadians` was calculated with atan2(dx, dy) and that dy is positive when
  /// pointing down.
  public var angle: CGFloat { displacement != 0.0 ? 180.0 - angleRadians * 180.0 / .pi : 0.0 }