Skip to content

docs(octo): refresh package doc and fix stale comment references#29

Merged
lml2468 merged 1 commit into
mainfrom
docs/octo-comments-cleanup
Jun 12, 2026
Merged

docs(octo): refresh package doc and fix stale comment references#29
lml2468 merged 1 commit into
mainfrom
docs/octo-comments-cleanup

Conversation

@lml2468

@lml2468 lml2468 commented Jun 12, 2026

Copy link
Copy Markdown
Collaborator

Comment/doc-only cleanup of the Octo integration — no code change.

What

  • doc.go was badly stale: it pointed at the old internal/integrations/im transport path (renamed to octo/transport in refactor(octo): move WuKongIM transport into octo/transport subpackage #13) and still claimed 'implementation lands in later phases (dispatcher, outbound, binding, hub)' — all long since implemented. Rewrote it as an accurate package overview: the one-directional transport → business layering and the role of each moving part (Hub, Dispatcher, Patcher, OutcomeReplier, BindingTokenService, InstallationService), plus a pointer to the octo_cleanup scheduler job.
  • types.go: InboundMessage doc referenced internal/integrations/im → corrected to internal/integrations/octo/transport.
  • Grammar: an transport.Xa transport.X in types.go, connector.go, hub.go.

Left intentionally

  • im_token — a real WuKongIM register-response field, not a leftover of the imtransport package rename.
  • im.example / im.deepminer URLs in tests.

go build + go vet clean (comments only).

Comment/doc-only cleanup of the Octo integration (no code change):

- doc.go: was badly stale — pointed at the old internal/integrations/im
  transport path and still said 'implementation lands in later phases'.
  Rewrote it as an accurate package overview: the one-directional
  transport->business layering and the role of each moving part (Hub,
  Dispatcher, Patcher, OutcomeReplier, BindingTokenService,
  InstallationService) plus the octo_cleanup scheduler job.
- types.go: InboundMessage doc referenced internal/integrations/im →
  internal/integrations/octo/transport.
- Grammar: 'an transport.X' → 'a transport.X' in types.go, connector.go,
  hub.go.

Left intentionally: 'im_token' (a real WuKongIM register-response field,
not a leftover of the im→transport package rename) and the im.example /
im.deepminer URLs in tests.
@lml2468 lml2468 merged commit fe606f9 into main Jun 12, 2026
4 checks passed
@lml2468 lml2468 deleted the docs/octo-comments-cleanup branch June 12, 2026 02:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant