docs(onboarding): Author the missing README for the migrate-keys workspace member

Open Beginner friendly
#668 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
1/5
Estimated time
1-3 hours
Newbie friendliness
85/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
markdown, rust
Domain
documentation

Research direction

Create bin/migrate-keys/README.md, using the one-line description from that crate’s Cargo.toml and the existing README pattern in api, store, ingest or webhooks. Read docs/runbook-migrate-keys.md and docs/threat-model.md first; cover when to run key rotation, the --batch-size flag and link the relevant documentation. Keep it under 40 lines, then preview the Markdown and run the commands required by the issue.

Written by the indexing model from the issue text.

Description

area/integration documentation good first issue help wanted

Description

bin/migrate-keys has no README, unlike api, store, ingest and webhooks, so newcomers cannot tell what it is for.

Requirements and context

  • Where: bin/migrate-keys/README.md
  • Security: Follow docs/threat-model.md; no secrets, tokens or personal data in code, logs, tests or commit messages.
  • Testing: just fmt-check, just lint and just test must pass; add or update tests for the change.
  • Documentation: Update the nearest doc if behaviour changes; otherwise no doc change is needed.

Suggested execution

  • Comment on this issue to claim it, then fork the repository and branch from main.
  • Branch name: git checkout -b docs/migrate-keys-readme

Implement changes

  • Create a short README (under 40 lines) covering when to run the key rotation tool and the --batch-size flag, linking docs/runbook-migrate-keys.md.
  • Copy the one-line description from the crate's Cargo.toml.
  • Link the relevant file under docs/.

Test and commit

  • Preview the Markdown and run any command you document.
  • Run just fmt, just lint and just test locally before pushing (see CONTRIBUTING.md).
  • Commit with a conventional message and keep the change small and focused.

Example commit message

docs(migrate-keys): add README

Guidelines

  • Open the PR against main and link it with Closes #<this issue>.
  • Keep the diff focused on this issue; no unrelated refactors or formatting churn.
  • One line per comment, no bloated code; follow patterns already used in the crate.
  • Never commit secrets, .env files or real keys; use public test vectors only.
  • CI (fmt, clippy -D warnings, tests) must be green before requesting review.
  • Ask in the issue thread if anything is unclear before starting.
Dominant language
Rust
Stars
0
Forks
91
Avg merge
5h 23m
Merged PRs (30d)
4

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from Octo-Protocol-org/Octo-Protocol

All issues in Octo-Protocol-org/Octo-Protocol

Similar issues

More Rust issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.