docs: compare registered and imported group control

[aspiers]

Summary

Restructure Step 1 of the integration guide so registration and import are presented as equal alternatives, with their account-control implications explained before either procedure.

Changes

• present group.register and group.import as Step 1a and Step 1b under a shared Step 1
• add an upfront comparison of the starting account, email, primary password, CGS app password, recovery/rotation keys, and effective account-level control
• distinguish the CGS owner governance role from control of the underlying PDS account
• document the intended future transfer of full account control for registered groups, which could leave the owner in the same effective position as creating and importing the account themselves
• clearly label that full account-control transfer as not yet supported

Testing

• pnpm dlx prettier@3.8.1 --check docs/integration-guide.md
• git diff --check

Tests were not run because this is a documentation-only change.

Summary by CodeRabbit

• Documentation
  • Updated the integration guide with clearer guidance for setting up group accounts.
  • Added a comparison of registration and import options, including credential, recovery, and account-control considerations.
  • Clarified import parameters such as owner identity, email, and app password requirements.
  • Documented service authentication behavior and noted that importing does not modify the account’s DID document.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 1009ed56-5911-43a6-93c9-8d6861ab1180

📥 Commits

Reviewing files that changed from the base of the PR and between 23f02e9 and edb9e4a.

📒 Files selected for processing (1)

• docs/integration-guide.md

---

📝 Walkthrough

Walkthrough

The integration guide replaces generic group registration guidance with a register-versus-import account setup model, clarifies import parameters and authentication details, and documents ownerDid validation and DID document behavior.

Changes

Group account documentation

Layer / File(s)	Summary
Account setup and import guidance docs/integration-guide.md	Step 1 now compares group.register and group.import; import guidance defines ownerDid, email, appPassword, and account-control behavior, including DID document handling.

Estimated code review effort: 1 (Trivial) | ~5 minutes

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes the main documentation change: comparing control between registered and imported group accounts.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/group-control-comparison

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

[railway-app]

🚅 Deployed to the certified-group-service-pr-71 environment in CGS

Service	Status	Web	Updated (UTC)
certified-group-service	✅ Success (View Logs)	Web	Jul 16, 2026 at 2:03 pm
CGS demo app	✅ Success (View Logs)	Web	Jul 16, 2026 at 2:03 pm