Skip to content

docs(store): correct misleading and ungrammatical doc comments - #3508

Open
zjuncal wants to merge 1 commit into
evstack:mainfrom
zjuncal:main
Open

zjuncal wants to merge 1 commit into
evstack:mainfrom
zjuncal:main

Conversation

@zjuncal

@zjuncal zjuncal commented Nov 12, 2026 •

Copy link
Copy Markdown

Overview

Three comment-only fixes in pkg/store. No behavior changes.

  • types.go:102 — Rollback deletes x height from the ev-node store. has a leftover x placeholder and does not describe the method. The implementation comment at store.go:250 already says "rolls back block data until the given height"; the interface comment now matches it.
  • types.go:97 / store.go:219 — GetMetadata returns a single []byte, but the comment said "returns values ... with SetMetadata". Now "returns the value stored for the given key by SetMetadata".
  • types.go:64 / store.go:184 — "saves arbitrary value" was missing an article; now "saves an arbitrary value".

The interface and implementation copies of the Metadata doc comments are kept in sync. Follows the recent comment cleanups in #3484 and #3479; none of these lines were touched by those changes.

Summary by CodeRabbit

  • Documentation
    • Clarified descriptions of metadata storage and retrieval.
    • Updated rollback documentation to specify the height up to which rollback proceeds.

Signed-off-by: zjuncal <naclzju@outlook.com>
@coderabbitai

coderabbitai Bot commented Nov 12, 2026 •

Copy link
Copy Markdown
Contributor

Explain Change →

No actionable comments were generated in the recent review.

Walkthrough

Comments for SetMetadata, GetMetadata, and Rollback were clarified. No declarations or runtime behavior changed.

Changes: Store API comments

Layer / File(s) Summary
Clarify store API comments
pkg/store/store.go, pkg/store/types.go
The comments describe metadata as an arbitrary value, refer to the value stored for a given key, and state that rollback proceeds until the given height.

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

Change: Other

Suggested reviewers: tac0turtle, tzdybal, julienrbrt

Merge Risk: Minimal · up to 10283

This is a documentation-only wording cleanup in store comments with no behavior change, so it is safe to merge.

Pre-merge checks: Passed 4

Check name Status Explanation
Title check Passed The title uses the semantic commit form and names the main change: correcting misleading and ungrammatical doc comments in pkg/store. The changeset only edits comments in pkg/store/store.go and pkg/st…
Description check Passed The description follows the template's Overview section. It explains the three comment fixes, the reason for each (a leftover 'x' placeholder, a return-type mismatch in GetMetadata, and a missing arti…
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.
Full details: Title check

Explanation

The title uses the semantic commit form and names the main change: correcting misleading and ungrammatical doc comments in pkg/store. The changeset only edits comments in pkg/store/store.go and pkg/store/types.go, and the description and objectives confirm this scope.

Full details: Description check

Explanation

The description follows the template's Overview section. It explains the three comment fixes, the reason for each (a leftover 'x' placeholder, a return-type mismatch in GetMetadata, and a missing article), and states that there are no behavior changes. It also links related PRs #3484 and #3479. It does not use the template's 'Closes #' issue reference, but the template marks that as an example, and the explanation covers the required context.

Finishing Touches

Generate unit tests (beta)

  • Create a new PR
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

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

Recent review info

Run configuration

  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: defaults
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 26a648c0-1473-4cd5-be16-c7349fab4990
Commits

Reviewing files that changed from the base of the PR and between 28d2714 and 1028376.

Files selected for processing: 2

  • pkg/store/store.go
  • pkg/store/types.go

Included review availability: This review used your included allowance. Your plan provides up to 2 included reviews per hour; 1 remain after this review.

This branch has not been deployed

No deployments
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