Skip to content

docs: add ADR index and v0.4 requirements reference#246

Merged
EffortlessSteven merged 1 commit into
mainfrom
docs/adr-requirements-v0.4
Mar 13, 2026
Merged

docs: add ADR index and v0.4 requirements reference#246
EffortlessSteven merged 1 commit into
mainfrom
docs/adr-requirements-v0.4

Conversation

@EffortlessSteven

Copy link
Copy Markdown
Member

Summary

This pulls the local docs batch out of main and puts it on its own review lane.

What changed

  • add an ADR set under docs/adr/ plus an ADR index
  • refresh docs/README.md to point at the current docs structure
  • update docs/explanation/roadmap.md
  • add docs/reference/requirements-v0.4.md

Why

  • the RNG and release lanes should stay focused on shipping work
  • these docs changes are substantial enough to deserve separate review
  • keeping them in a dedicated PR prevents accidental carry-over into release prep

Testing

  • docs-only changes

@gemini-code-assist

Copy link
Copy Markdown

Warning

You have reached your daily quota limit. Please wait up to 24 hours and I will start processing your requests again!

@coderabbitai

coderabbitai Bot commented Mar 13, 2026

Copy link
Copy Markdown

Warning

Rate limit exceeded

@EffortlessSteven has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 23 minutes and 17 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: bf78a759-f9c6-487c-93b7-6eb1717290e1

📥 Commits

Reviewing files that changed from the base of the PR and between c38080b and 82a6cbf.

📒 Files selected for processing (30)
  • docs/README.md
  • docs/adr/0001-use-adr-template.md
  • docs/adr/0002-seed-boundary-abstraction.md
  • docs/adr/0003-order-independent-determinism.md
  • docs/adr/0004-microcrate-architecture.md
  • docs/adr/0005-cache-by-identity.md
  • docs/adr/0006-negative-fixtures-first-class.md
  • docs/adr/0007-shape-first-outputs.md
  • docs/adr/0008-extension-traits-pattern.md
  • docs/adr/0009-adapter-separation.md
  • docs/adr/0010-jwks-deterministic-ordering.md
  • docs/adr/0011-kid-generation-blake3.md
  • docs/adr/0012-length-prefixed-hashing.md
  • docs/adr/0013-x509-deterministic-time.md
  • docs/adr/0014-x509-serial-number.md
  • docs/adr/0015-deterministic-corruption.md
  • docs/adr/0016-spec-stable-encoding.md
  • docs/adr/0017-seed-debug-redaction.md
  • docs/adr/0018-no-unsafe-code.md
  • docs/adr/0019-test-only-positioning.md
  • docs/adr/0020-no-std-support.md
  • docs/adr/0021-publish-order-orchestration.md
  • docs/adr/0022-adapter-feature-flags.md
  • docs/adr/0023-two-layer-adapter.md
  • docs/adr/0024-bias-free-base62.md
  • docs/adr/0025-pr-scoped-ci.md
  • docs/adr/0026-empty-default-features.md
  • docs/adr/README.md
  • docs/explanation/roadmap.md
  • docs/reference/requirements-v0.4.md
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch docs/adr-requirements-v0.4
📝 Coding Plan
  • Generate coding plan for human review comments

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.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 82a6cbf996

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".


```bash
# No rand types in public API
cargo doc -p uselesskey --no-deps 2>&1 | grep -i "rand::" || echo "PASS"

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Make Gate 1 fail when docs generation fails

This acceptance command can produce a false pass whenever cargo doc fails, because grep is the only status being checked and || echo "PASS" runs when grep finds no match. In that scenario (for example, a rustdoc compile error), the gate still prints PASS even though API cleanliness was never validated, which weakens the reliability of the documented release checklist.

Useful? React with 👍 / 👎.

@EffortlessSteven EffortlessSteven merged commit 1c2b61d into main Mar 13, 2026
4 checks passed
@EffortlessSteven EffortlessSteven deleted the docs/adr-requirements-v0.4 branch April 3, 2026 04:38
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