CXP-1130: Correct last-activity examples in connector docs

[luisina-santos]

Problem

The Sync member last activity section of docs/connector.mdx illustrated last activity with examples the GitHub organization audit log does not record:

...the most recent recorded action across all synced organizations (for example, commenting on an issue or pull request, reviewing code, or changing a setting).

Two of those three examples cannot produce a last-activity date. Measured on both include=web and include=all, issue and pull request comments and code reviews produce no audit-log events at all. Administrative actions do.

The same error appeared a second time in the Git-operations paragraph, whose parenthetical (no PR reviews, comments, or settings changes) read as though reviews and comments would otherwise have counted.

The section already stated correctly that unrecorded activity yields no date, so the page contradicted itself: it explained the rule and then gave examples that violate it.

Impact

Silent and user-facing. An organization whose members write and review code but administer nothing enables the feature, sees an empty Last login column for every account, and finds nothing in the docs explaining why — the page named their exact workflow as an example of what counts.

Change

Docs only, one file:

1. Example list replaced with administrative actions that are actually recorded.
2. New What is not counted paragraph naming comments, reviews and commits explicitly.
3. Git-operations paragraph reworded so it builds on that rather than contradicting it.

No connector change. The connector surfaces what the audit log returns; only the description of what that covers was wrong.

Notes for the reviewer

• The existing claim that raw Git operations are excluded "to keep this fast on large organizations" was left as-is — the measurement covers content activity, not the git-events category.
• Administrative examples: creating a team is what the validation actually exercised and it produced events. Repository create/delete and settings changes were not directly measured.

Found while validating the last-activity feature on v0.0.18 (FIX-05). That test case passes; this was a separate documentation defect.

Closes CXP-1130

🤖 Generated with Claude Code

[linear-code]

CXP-1130

[github-actions]

Connector PR Review: CXP-1130: Correct last-activity examples in connector docs

Blocking Issues: 0 | Suggestions: 0 | Threads Resolved: 0
Criteria: Criteria status: loaded .claude/skills/ci-review.md from trusted base 4f6709b28c32.
Review mode: full
View review run

Review Summary

The full PR diff was scanned for security and correctness; it touches a single documentation file (docs/connector.mdx, +4/-2) with no Go, config, go.mod, or go.sum changes. The revised wording matches the implementation: the vendored activity feed queries the organization audit log with an include filter of "web" (vendor/github.com/conductorone/baton-github/pkg/connector/usage_event_feed.go:150-160), so excluding raw Git operations and framing last activity around administrative events is accurate, and the section no longer contradicts its own "unrecorded activity yields no date" rule. No new issues found.

Security Issues

None found.

Correctness Issues

None found.

Suggestions

None.

[github-actions]

No blocking issues found.