Skip to content

Update KYC steps in onboarding documentation#600

Open
bram-vdberg wants to merge 1 commit intomainfrom
Update-KYC-Description
Open

Update KYC steps in onboarding documentation#600
bram-vdberg wants to merge 1 commit intomainfrom
Update-KYC-Description

Conversation

@bram-vdberg
Copy link
Contributor

@bram-vdberg bram-vdberg commented Mar 10, 2026

Description

This PR updates the KYC section of the solver on-boarding guide to provide a more detailed description of the process.

Changes

Updated https://docs.cow.fi/cow-protocol/tutorials/solvers/onboard#requirements-for-joining-the-cow-dao-bonding-pool

Summary by CodeRabbit

  • Documentation
    • Restructured solver onboarding KYC requirements with a clearer list of required documents including incorporation details and shareholder/developer identification
    • Added KYC process timeline expectations (1-3 working days) and clarified document submission procedures

@bram-vdberg bram-vdberg requested a review from a team as a code owner March 10, 2026 08:58
@vercel
Copy link

vercel bot commented Mar 10, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview Mar 10, 2026 8:58am

Request Review

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Mar 10, 2026

📝 Walkthrough

Walkthrough

Documentation restructure for solver onboarding KYC requirements, converting narrative text into a structured bullet-point list with explicit document requirements and processing timeline.

Changes

Cohort / File(s) Summary
Documentation Update
docs/cow-protocol/tutorials/solvers/onboard.md
Restructured KYC requirements from narrative format to organized bullet list, adding incorporation details, passport requirements for shareholders/developers, and clarified 1–3 working day processing timeline.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐰 With carrots and clarity, our docs now shine bright,
KYC steps laid out in a structured delight,
No tangled prose, just bullets so clear—
Onboarding's now smoother, the path is sincere! 🥕✨

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately summarizes the main change: updating KYC steps in the onboarding documentation.
Description check ✅ Passed The description provides context and lists changes, but the Changes section lacks detailed bullet points as shown in the template.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch Update-KYC-Description

Tip

Try Coding Plans. Let us write the prompt for your AI agent so you can ship faster (with fewer bugs).
Share your feedback on Discord.


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

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/cow-protocol/tutorials/solvers/onboard.md`:
- Around line 30-33: Revise the ambiguous passport requirement sentence ("one or
two passports of the main shareholders and developers") to explicitly list whose
passports are required—e.g., "one or two passport copies for each main
shareholder and for each core developer listed on the solver team"—so teams know
to include passports for every named main shareholder and every listed
developer; also update the following sentence to US English by changing "Do not
send this before the meeting, we will explain the process during the meeting so
that you can send the documents afterwards" to "Do not send these before the
meeting; we will explain the process during the meeting so that you can send the
documents afterward."

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: ea0fc3a4-9490-482d-b36b-343815744d27

📥 Commits

Reviewing files that changed from the base of the PR and between 1e54f9f and 1b3bab6.

📒 Files selected for processing (1)
  • docs/cow-protocol/tutorials/solvers/onboard.md

Comment on lines +30 to +33
- Incorporation details of the company behind the solver that includes details of who the shareholders are
- One or two passports of the main shareholders and developers of the solver

Do not send this before the meeting, we will explain the process during the meeting so that you can send the documents afterwards. We usually expect the KYC process to take about 1 to 3 working days, but it may vary.
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Clarify which people’s passports are required.

Line 31 is still ambiguous about scope: “one or two passports of the main shareholders and developers” can mean one or two passports total, or passports for whichever people CoW considers “main.” Please spell out exactly whose documents are needed; otherwise teams can show up with the wrong KYC packet. While touching this, Line 33 should read “Do not send these before the meeting … afterward” for agreement and consistent US English.

🧰 Tools
🪛 LanguageTool

[locale-violation] ~33-~33: In American English, ‘afterward’ is the preferred variant. ‘Afterwards’ is more commonly used in British English and other dialects.
Context: ...ting so that you can send the documents afterwards. We usually expect the KYC process to t...

(AFTERWARDS_US)

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/cow-protocol/tutorials/solvers/onboard.md` around lines 30 - 33, Revise
the ambiguous passport requirement sentence ("one or two passports of the main
shareholders and developers") to explicitly list whose passports are
required—e.g., "one or two passport copies for each main shareholder and for
each core developer listed on the solver team"—so teams know to include
passports for every named main shareholder and every listed developer; also
update the following sentence to US English by changing "Do not send this before
the meeting, we will explain the process during the meeting so that you can send
the documents afterwards" to "Do not send these before the meeting; we will
explain the process during the meeting so that you can send the documents
afterward."

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.

2 participants