Skip to content

Comments

Integrate DocC plugin#128

Merged
0xLeif merged 12 commits intomainfrom
codex/update-docc.yml-and-package.swift-for-spm-plugin
Jun 7, 2025
Merged

Integrate DocC plugin#128
0xLeif merged 12 commits intomainfrom
codex/update-docc.yml-and-package.swift-for-spm-plugin

Conversation

@0xLeif
Copy link
Owner

@0xLeif 0xLeif commented Jun 4, 2025

Summary

  • add Swift DocC plugin dependency
  • update DocC workflow to use swift package generate-documentation
  • run documentation workflow on every push

Testing

  • swift test -v

https://chatgpt.com/codex/tasks/task_e_683fb10a19288326b3ebb7062c003ce9

* Fix docc workflow

* Update docc.yml
@0xLeif 0xLeif requested a review from Copilot June 7, 2025 15:59
@0xLeif 0xLeif self-assigned this Jun 7, 2025
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR integrates the DocC plugin into the project to improve documentation generation. Key changes include:

  • Adding a swift-docc-plugin dependency and updating Package.swift.
  • Replacing the xcodebuild-based documentation build with swift package generate-documentation.
  • Updating GitHub workflows for Swift setup and GitHub Pages deployment.

Reviewed Changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated no comments.

File Description
Sources/AppState/Application/Application.swift Added @mainactor to the static logger for thread isolation clarity.
Package.swift Added swift-docc-plugin dependency for DocC integration.
.github/workflows/macOS.yml Updated workflow to include Swift setup with version 6.1.0.
.github/workflows/docc.yml Replaced xcodebuild steps with swift package generate-documentation and updated deployment actions.
Comments suppressed due to low confidence (2)

.github/workflows/docc.yml:39

  • [nitpick] Consider adding an inline comment explaining the switch from 'xcodebuild docbuild' to 'swift package generate-documentation' to aid future maintainers.
swift package --allow-writing-to-directory docs \

Sources/AppState/Application/Application.swift:17

  • Ensure the @mainactor annotation on 'logger' is intentional; verify that binding logger access to the main thread aligns with all usage contexts in production.
@MainActor

@0xLeif 0xLeif merged commit 58a6e70 into main Jun 7, 2025
4 of 6 checks passed
@0xLeif 0xLeif deleted the codex/update-docc.yml-and-package.swift-for-spm-plugin branch June 7, 2025 16:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant