Skip to content

chore: docs fixington #24711

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 5 commits into
base: main
Choose a base branch
from
Draft

chore: docs fixington #24711

wants to merge 5 commits into from

Conversation

aljo242
Copy link
Contributor

@aljo242 aljo242 commented May 6, 2025

Closes: SDK-286

create epic script to automate doc fixing

Summary by CodeRabbit

  • Documentation
    • Updated all Cosmos SDK source code reference links in documentation files to point to the latest stable release (v0.53.0), including adjusted line ranges where necessary.
    • Improved consistency and accuracy of external code references across multiple module and guide documents.
    • No changes were made to the descriptive content, logic, or code examples—only the URLs were updated.
  • Chores
    • Added a script to automate updating Markdown documentation links to the latest Cosmos SDK version.

Copy link

ironbird-prod bot commented May 6, 2025

Ironbird - launch a network To use Ironbird, you can use the following commands:
  • /ironbird start OR /ironbird start --load-test-config= - Launch a testnet with the specified chain and load test configuration.
  • /ironbird chains - List of chain images that ironbird can use to spin-up testnet
  • /ironbird loadtests - List of load test modes that ironbird can run against testnet
Custom Load Test Configuration You can provide a custom load test configuration using the `--load-test-config=` flag:
/ironbird start cosmos --load-test-config={
  "block_gas_limit_target": 0.75,
  "num_of_blocks": 50,
  "msgs": [
    {"weight": 0.3, "type": "MsgSend"},
    {"weight": 0.3, "type": "MsgMultiSend"},
	{"weight": 0.4, "type": "MsgArr", "ContainedType": "MsgSend", "NumMsgs": 3300}
  ]
}

Use /ironbird loadtests to see more examples.

Copy link
Contributor

coderabbitai bot commented May 6, 2025

📝 Walkthrough

Walkthrough

The changes consist of systematic updates to documentation files across the repository, specifically targeting external links that reference source code in the Cosmos SDK GitHub repository. All affected links are updated to point to the stable v0.53.0 release and, where necessary, adjusted line ranges to match the updated codebase. Additionally, a new Python script is introduced to automate the process of updating such links in Markdown files.

Changes

File(s) Change Summary
client/v2/README.md, collections/README.md, docs/DOC_WRITING_GUIDELINES.md, Updated Cosmos SDK source code reference URLs to v0.53.0 and adjusted line ranges where needed.
docs/architecture/adr-047-extend-upgrade-plan.md, docs/docs/build/abci/03-vote-extensions.md,
docs/docs/build/building-apps/01-app-go-di.md, docs/docs/build/building-apps/04-vote-extensions.md,
docs/docs/build/building-modules/02-messages-and-queries.md, docs/docs/build/building-modules/03-msg-services.md,
docs/docs/build/building-modules/06-keeper.md, docs/docs/build/building-modules/07-invariants.md,
docs/docs/build/building-modules/08-genesis.md, docs/docs/build/building-modules/09-module-interfaces.md,
docs/docs/build/building-modules/12-errors.md, docs/docs/build/building-modules/13-upgrade.md,
docs/docs/build/building-modules/14-simulator.md, docs/docs/build/building-modules/15-depinject.md,
docs/docs/build/tooling/00-protobuf.md, docs/docs/learn/advanced/02-context.md,
docs/docs/learn/advanced/05-encoding.md, docs/docs/learn/advanced/06-grpc_rest.md,
docs/docs/learn/advanced/08-events.md, docs/docs/learn/advanced/11-runtx_middleware.md,
docs/docs/learn/advanced/12-simulation.md, docs/docs/learn/beginner/04-gas-fees.md,
x/authz/README.md, x/bank/README.md, x/circuit/README.md, x/crisis/README.md,
x/distribution/README.md, x/feegrant/README.md, x/genutil/README.md, x/gov/README.md,
x/mint/README.md, x/slashing/README.md, x/staking/README.md, x/upgrade/README.md
Grouped: All above files Updated all Cosmos SDK GitHub links to reference v0.53.0 with corrected line numbers; no content or logic changes.
scripts/fix-links.py Added a new Python script to automate updating GitHub source code links in Markdown files to a target version.

Sequence Diagram(s)

sequenceDiagram
    participant User
    participant fix-links.py
    participant Git
    participant MarkdownFile

    User->>fix-links.py: Run script (optionally with dry-run)
    fix-links.py->>MarkdownFile: Scan for GitHub source links
    loop For each link
        fix-links.py->>Git: Fetch file at old version
        fix-links.py->>Git: Fetch file at target version (v0.53.0)
        fix-links.py->>fix-links.py: Fuzzy match line ranges
        alt Match found
            fix-links.py->>MarkdownFile: Update link with new version/line range
        else No match
            fix-links.py->>docs_todo.log: Log failure
        end
    end
    fix-links.py->>User: Print summary/results
Loading
✨ Finishing Touches
  • 📝 Generate Docstrings

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
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

‼️ IMPORTANT
Auto-reply has been disabled for this repository in the CodeRabbit settings. The CodeRabbit bot will not respond to your replies unless it is explicitly tagged.

  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai generate unit testing code for this file.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and generate unit testing code.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
    • @coderabbitai help me debug CodeRabbit configuration file.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai generate docstrings to generate docstrings for this PR.
  • @coderabbitai generate sequence diagram to generate a sequence diagram of the changes in this PR.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

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: 2

🔭 Outside diff range comments (6)
x/mint/README.md (1)

97-98: ⚠️ Potential issue

Stale protobuf link for Params section
The Params section still references v0.47.0-rc1. For consistency, update this link to v0.53.0, e.g.:

- https://github.com/cosmos/cosmos-sdk/blob/v0.47.0-rc1/proto/cosmos/mint/v1beta1/mint.proto#L26-L59
+ https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/proto/cosmos/mint/v1beta1/mint.proto#L26-L59
docs/docs/learn/advanced/06-grpc_rest.md (1)

81-81: ⚠️ Potential issue

Inconsistent version in Swagger script link.
The Swagger generation script still points to v0.53.0-rc.2. To maintain consistency, update it to v0.53.0 (e.g., .../blob/v0.53.0/scripts/protoc-swagger-gen.sh).

docs/docs/build/building-modules/07-invariants.md (1)

61-61: ⚠️ Potential issue

Outdated staking invariants link.
The example at x/staking/keeper/invariants.go#L12-L22 still uses v0.50.0-alpha.0 while others point to v0.53.0. Please update this link to the stable v0.53.0 release.

docs/docs/learn/advanced/05-encoding.md (1)

87-92: ⚠️ Potential issue

Outdated rc.2 links for auth tx module.
The x/auth/tx/decoder.go and x/auth/tx/encoder.go links still reference v0.53.0-rc.2. Update both to v0.53.0 to align with other docs.

docs/docs/learn/advanced/08-events.md (1)

145-145: ⚠️ Potential issue

Inconsistent link: leftover release-candidate tag.

The legacy-events link still references v0.53.0-rc.2 instead of the stable v0.53.0 tag.

Apply this diff to correct the reference:

-[legacy events](https://github.com/cosmos/cosmos-sdk/blob/v0.53.0-rc.2/x/bank/types/events.go)
+[legacy events](https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/x/bank/types/events.go)
x/feegrant/README.md (1)

44-45: ⚠️ Potential issue

Outdated link detected: old release-candidate reference remains.

The Go reference for FeeAllowanceI still points to v0.47.0-rc1. This should be updated to the stable v0.53.0 path (likely x/feegrant/fees.go or its new location).

🧹 Nitpick comments (7)
docs/docs/learn/advanced/12-simulation.md (1)

54-54: Grammar nitpick: subject–verb agreement.
Change “The list of available parameters are listed [here]” to “The list of available parameters is listed [here]” for correctness.

-The list of available parameters are listed [here](https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/x/simulation/client/cli/flags.go#L72-L90).
+The list of available parameters is listed [here](https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/x/simulation/client/cli/flags.go#L72-L90).
🧰 Tools
🪛 LanguageTool

[grammar] ~54-~54: Possible agreement error.
Context: ...ed. The list of available parameters are listed [here](https://github.com/cosmos...

(AGREEMENT_SENT_START)

docs/docs/learn/advanced/05-encoding.md (1)

151-151: Consistent phrasing: replace “Have a look at”.
Consider changing “Have a look at [a real-life example…]” to “Take a look at [a real-life example…]” for American English consistency.

-Have a look at [a real-life example in the x/auth module](...#L291-L293).
+Take a look at [a real-life example in the x/auth module](...#L291-L293).
🧰 Tools
🪛 LanguageTool

[locale-violation] ~151-~151: In American English, “take a look” is more commonly used.
Context: ...face` method to bundle these two steps. Have a look at [a real-life example in the x/auth m...

(HAVE_A_LOOK)

scripts/fix-links.py (5)

1-1: Add a she-bang to make the script directly executable

Including an explicit she-bang (#!/usr/bin/env python3) at the very top allows the script to be invoked as ./fix-links.py once the executable bit is set, improving developer ergonomics and CI integration.

+#!/usr/bin/env python3
 import re
 import subprocess

70-75: Open files with an explicit UTF-8 encoding to avoid locale-dependent failures

Relying on the platform’s default encoding can break the script on systems whose locale is not UTF-8 (e.g. Windows with CP-1252). Explicitly specifying the encoding guarantees consistent behaviour across environments.

-    with open(file_path, 'r') as f:
+    with open(file_path, 'r', encoding="utf-8") as f:
     content = f.read()
…
-        with open(file_path, 'w') as f:
+        with open(file_path, 'w', encoding="utf-8") as f:
         f.write(new_content)

Also applies to: 122-125


43-58: Pre-normalise new_lines once to avoid O(N²) work inside the sliding window

normalize_lines(window) is executed for every window, producing repeated string allocations and unnecessary regex calls. Normalising new_lines a single time outside the loop reduces the complexity from O(n·m) to O(n) where n is len(new_lines) and m is old_len.

-    best_score = 0.0
+    new_norm_lines = normalize_lines(new_lines)
+    best_score = 0.0
     best_range = None
…
-    for i in range(len(new_lines) - old_len + 1):
-        window = new_lines[i:i + old_len]
-        window_str = "\n".join(normalize_lines(window))
+    for i in range(len(new_norm_lines) - old_len + 1):
+        window = new_norm_lines[i:i + old_len]
+        window_str = "\n".join(window)

60-64: Gate verbose candidate printing behind a --verbose flag

Dumping the top-3 candidates for every link quickly becomes noisy when processing hundreds of files. Wrapping these diagnostics behind an optional flag keeps default output concise while preserving the invaluable debug information when needed.

-    top_candidates = sorted(candidates, key=lambda x: -x[2])[:3]
-    for start, end, score in top_candidates:
-        print(f"🔎 Candidate range L{start}-L{end} scored {score:.2f}")
+    if '--verbose' in sys.argv:
+        top_candidates = sorted(candidates, key=lambda x: -x[2])[:3]
+        for start, end, score in top_candidates:
+            print(f"🔎 Candidate range L{start}-L{end} scored {score:.2f}")

23-29: Preserve text encoding when calling git show

git show may emit binary or non-UTF-8 data for certain files. Passing encoding="utf-8", errors="replace" prevents UnicodeDecodeErrors from crashing the script while still returning usable text for comparison.

-        result = subprocess.run(
-            ["git", "show", f"{version}:{filepath}"],
-            capture_output=True,
-            text=True,
-            check=True
-        )
+        result = subprocess.run(
+            ["git", "show", f"{version}:{filepath}"],
+            capture_output=True,
+            text=True,
+            encoding="utf-8",
+            errors="replace",
+            check=True
+        )
📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 4a4cc47 and 783bee6.

📒 Files selected for processing (38)
  • client/v2/README.md (1 hunks)
  • collections/README.md (1 hunks)
  • docs/DOC_WRITING_GUIDELINES.md (1 hunks)
  • docs/architecture/adr-047-extend-upgrade-plan.md (1 hunks)
  • docs/docs/build/abci/03-vote-extensions.md (1 hunks)
  • docs/docs/build/building-apps/01-app-go-di.md (4 hunks)
  • docs/docs/build/building-apps/04-vote-extensions.md (1 hunks)
  • docs/docs/build/building-modules/02-messages-and-queries.md (3 hunks)
  • docs/docs/build/building-modules/03-msg-services.md (3 hunks)
  • docs/docs/build/building-modules/06-keeper.md (1 hunks)
  • docs/docs/build/building-modules/07-invariants.md (2 hunks)
  • docs/docs/build/building-modules/08-genesis.md (3 hunks)
  • docs/docs/build/building-modules/09-module-interfaces.md (6 hunks)
  • docs/docs/build/building-modules/12-errors.md (1 hunks)
  • docs/docs/build/building-modules/13-upgrade.md (1 hunks)
  • docs/docs/build/building-modules/14-simulator.md (7 hunks)
  • docs/docs/build/building-modules/15-depinject.md (4 hunks)
  • docs/docs/build/tooling/00-protobuf.md (3 hunks)
  • docs/docs/learn/advanced/02-context.md (2 hunks)
  • docs/docs/learn/advanced/05-encoding.md (5 hunks)
  • docs/docs/learn/advanced/06-grpc_rest.md (2 hunks)
  • docs/docs/learn/advanced/08-events.md (3 hunks)
  • docs/docs/learn/advanced/11-runtx_middleware.md (1 hunks)
  • docs/docs/learn/advanced/12-simulation.md (4 hunks)
  • docs/docs/learn/beginner/04-gas-fees.md (2 hunks)
  • scripts/fix-links.py (1 hunks)
  • x/authz/README.md (9 hunks)
  • x/bank/README.md (5 hunks)
  • x/circuit/README.md (2 hunks)
  • x/crisis/README.md (1 hunks)
  • x/distribution/README.md (5 hunks)
  • x/feegrant/README.md (7 hunks)
  • x/genutil/README.md (1 hunks)
  • x/gov/README.md (8 hunks)
  • x/mint/README.md (1 hunks)
  • x/slashing/README.md (2 hunks)
  • x/staking/README.md (15 hunks)
  • x/upgrade/README.md (2 hunks)
🧰 Additional context used
🪛 LanguageTool
docs/docs/build/building-modules/09-module-interfaces.md

[style] ~55-~55: Consider removing “of” to be more concise
Context: ...ws the root command to easily aggregate all of the transaction commands for each module. H...

(ALL_OF_THE)

docs/docs/build/building-modules/13-upgrade.md

[uncategorized] ~63-~63: Possible missing comma found.
Context: ...esses to be prefixed by their length in bytes as outlined in [ADR-028](../architectur...

(AI_HYDRA_LEO_MISSING_COMMA)

docs/docs/learn/advanced/12-simulation.md

[grammar] ~54-~54: Possible agreement error.
Context: ...ed. The list of available parameters are listed [here](https://github.com/cosmos...

(AGREEMENT_SENT_START)

docs/docs/build/building-modules/03-msg-services.md

[uncategorized] ~30-~30: A punctuation mark might be missing here.
Context: ... When possible, the existing module's [Keeper`](./06-keeper.md) should implemen...

(AI_EN_LECTOR_MISSING_PUNCTUATION)

docs/docs/learn/advanced/05-encoding.md

[locale-violation] ~151-~151: In American English, “take a look” is more commonly used.
Context: ...face` method to bundle these two steps. Have a look at [a real-life example in the x/auth m...

(HAVE_A_LOOK)

docs/docs/build/building-modules/08-genesis.md

[style] ~74-~74: ‘prior to’ might be wordy. Consider a shorter alternative.
Context: ...for modules to submit state transitions prior to the first block. This is used by `x/gen...

(EN_WORDINESS_PREMIUM_PRIOR_TO)

docs/docs/build/building-modules/14-simulator.md

[uncategorized] ~65-~65: Loose punctuation mark.
Context: ... - HasWeightedOperationsXWithProposals: [x/gov](https://github.com/cosmos/cosmo...

(UNLIKELY_OPENING_PUNCTUATION)

⏰ Context from checks skipped due to timeout of 90000ms (7)
  • GitHub Check: build (arm64)
  • GitHub Check: Check up to date mocks
  • GitHub Check: build (amd64)
  • GitHub Check: dependency-review
  • GitHub Check: Check docs build
  • GitHub Check: markdown-link-check
  • GitHub Check: Summary
🔇 Additional comments (128)
docs/docs/build/abci/03-vote-extensions.md (1)

38-38: Consistent external link update
The link to sdk.VerifyVoteExtensionHandler has been correctly updated to point to the stable v0.53.0 release with the new line range.

docs/docs/learn/advanced/11-runtx_middleware.md (1)

16-17: Updated recovery.go reference to stable release
The URL for recovery.go is now accurately pointing to v0.53.0 and the referenced lines L14–L17.

docs/docs/build/building-modules/06-keeper.md (1)

44-44: Keeper type definition link updated
The keeper.go reference is correctly updated to v0.53.0 targeting lines L24–L31, matching the stable release.

x/mint/README.md (1)

86-86: Protobuf link for Minter updated to v0.53.0
The mint.proto reference for the Minter message now correctly points to v0.53.0 lines L10–L24.

docs/docs/build/building-modules/12-errors.md (1)

46-46: Error wrapping example link updated
The keeper.go example link for error wrapping has been updated to v0.53.0 lines L122–L157 as intended.

client/v2/README.md (1)

153-153: Update external reference to stable v0.53.0 release.
The GitHub link now points to v0.53.0/x/auth/autocli.go#L25-L30. Please verify that the file path and line numbers exist in the v0.53.0 tag.

docs/DOC_WRITING_GUIDELINES.md (1)

34-34: Link reference updated to v0.53.0.
The GitHub snippet link now points to server/types/app.go#L68-L69 on the stable v0.53.0 tag. Looks consistent.

docs/docs/build/building-modules/13-upgrade.md (1)

63-63: Update migration example link to v0.53.0.
The link to migrateBalanceKeys now targets x/bank/migrations/v2/store.go#L55-L73 on v0.53.0. Confirm the line range aligns with the updated migration code.

🧰 Tools
🪛 LanguageTool

[uncategorized] ~63-~63: Possible missing comma found.
Context: ...esses to be prefixed by their length in bytes as outlined in [ADR-028](../architectur...

(AI_HYDRA_LEO_MISSING_COMMA)

x/circuit/README.md (2)

20-20: Updated message router check link to v0.53.0.
This link now points to baseapp/msg_service_router.go#L104-L115 on the v0.53.0 tag. Ensure the code at this location still corresponds to the message router logic.


103-103: Refreshed protobuf link for MsgAuthorizeCircuitBreaker.
The reference now targets proto/cosmos/circuit/v1/tx.proto#L36-L75 on v0.53.0. Verify that the message definition and line numbers match in this version.

docs/architecture/adr-047-extend-upgrade-plan.md (1)

22-22: Link updated to v0.53.0 for Plan message.
The hyperlink to the Plan protobuf now points to proto/cosmos/upgrade/v1beta1/upgrade.proto#L14 on v0.53.0. Please confirm the correct line location in the updated proto file.

docs/docs/learn/advanced/02-context.md (2)

23-23: Updated Context definition reference link to stable tag
The reference now correctly points to v0.53.0 in types/context.go for lines 40-67, aligning with the stable release.


44-45: Updated CometInfo and HeaderInfo links to v0.53.0
Both links now anchor to the stable v0.53.0 tag in core/comet/service.go and core/header/service.go, ensuring consistent, versioned references.

docs/docs/build/building-modules/09-module-interfaces.md (3)

30-30: Updated transaction command example link to v0.53.0
The CLI transaction command example now references the stable v0.53.0 tag in x/bank/client/cli/tx.go#L39-L72.


52-52: Updated NewTxCmd aggregation example link to v0.53.0
The example now points to x/bank/client/cli/tx.go#L22-L35 at the v0.53.0 tag, aligning with other updated references.


99-99: Updated CLI aggregation example link in module to v0.53.0
The GetTxCmd() link now correctly targets x/bank/module.go#L88-L90 on the v0.53.0 tag.

docs/docs/build/building-apps/04-vote-extensions.md (1)

43-43: Updated VerifyVoteExtensionHandler reference to v0.53.0
The link now points to the stable v0.53.0 tag in types/abci.go#L31-L32, ensuring a fixed reference to the handler definition.

x/genutil/README.md (3)

22-22: Updated application genesis struct link to v0.53.0
The reference now correctly points to x/genutil/types/genesis.go#L27-L37 on the v0.53.0 tag.


28-28: Updated genesis-to-consensus translation link to v0.53.0
The link now anchors to x/genutil/types/genesis.go#L148-L158 at the v0.53.0 tag, aligning with the stable release.


32-32: Updated server start logic reference to v0.53.0
The example now targets server/start.go#L414-L423 on the v0.53.0 tag, ensuring consistency with other documentation links.

x/crisis/README.md (1)

49-49: Correctly updated protobuf URL to v0.53.0
The MsgVerifyInvariant protobuf reference now points to v0.53.0 with the adjusted L26-L38 range as expected.

x/upgrade/README.md (2)

106-106: Upgrade proposal protobuf link updated
The MsgSoftwareUpgrade reference now correctly targets v0.53.0 lines L28-L38 in tx.proto.


118-118: Cancel upgrade proposal link updated
The MsgCancelUpgrade reference now correctly targets v0.53.0 lines L46-L54 in tx.proto.

x/bank/README.md (1)

134-134: Bank protobuf reference updated to v0.53.0
The bank.proto link now points to v0.53.0 and L11-L22, aligning with the updated SDK structure.

docs/docs/build/tooling/00-protobuf.md (5)

14-14: Makefile reference updated to v0.53.0
The Makefile link now correctly points to v0.53.0 lines L423-L438.


81-81: Clarified buf.gen.swagger.yaml description
The description for buf.gen.swagger.yaml is now clearer and accurately explains its role in generating Swagger docs.


96-96: buf.lock reference updated to v0.53.0
The buf.lock file link is now correctly pointing to v0.53.0 lines L1-L16.


101-101: Updated buf.yaml description context
The introductory text for buf.yaml now accurately reflects configuration fields in v0.53.0.


104-104: buf.yaml link updated to v0.53.0
The buf.yaml reference correctly points to v0.53.0 at L3.

x/slashing/README.md (2)

146-146: ValidatorSigningInfo protobuf link updated
The ValidatorSigningInfo reference now points to v0.53.0 lines L13-L34 in slashing.proto.


157-157: Params protobuf link updated
The Params reference now points to v0.53.0 lines L35-L56 in slashing.proto.

docs/docs/build/building-modules/08-genesis.md (5)

35-35: Stable link for DefaultGenesis updated correctly.
The DefaultGenesis() reference now points to v0.53.0 at #L61-L65. This aligns with the PR objective to use the stable release.


43-43: ValidateGenesis link updated to stable release.
The ValidateGenesis example now links to v0.53.0 at types/genesis.go#L62-L73. Confirm the lines still match the current code.


59-59: InitGenesis reference updated to v0.53.0.
The InitGenesis example now points to x/auth/keeper/genesis.go#L8-L32 on v0.53.0. Looks correct.


69-69: ExportGenesis link updated to stable tag.
The ExportGenesis example now references x/auth/keeper/genesis.go#L36-L46 on v0.53.0. Good.


77-77: GenesisTxHandler example updated.
The GenesisTxHandler link now points to core/genesis/txhandler.go#L3-L6 on v0.53.0. This maintains consistency.

docs/docs/learn/advanced/06-grpc_rest.md (2)

34-34: gRPC server hookup link updated to stable release.
The reference to server/types/app.go#L46-L48 now uses v0.53.0. Ensure the code lines still align.


69-69: REST route protobuf link updated.
The query.proto#L23-L30 reference is correctly updated to v0.53.0.

docs/docs/learn/advanced/12-simulation.md (3)

42-42: Simulation flags link updated to stable release.
The full list of flags now points to v0.53.0/x/simulation/client/cli/flags.go#L44-L69. Good.


64-64: Makefile example link updated.
The link to Makefile#L285-L314 now references v0.53.0. Looks correct.


86-86: Logger example link updated.
The keeper.go#L77-L81 link is now on v0.53.0. Confirm that the Keeper example still matches.

docs/docs/build/building-modules/07-invariants.md (4)

22-22: Invariant type link updated to stable release.
The types/invariant.go#L9 reference now uses v0.53.0. Good.


73-73: InvariantRegistry interface link updated.
The types/invariant.go#L14-L17 link is correctly updated to v0.53.0.


79-79: Crisis keeper registry link updated.
The x/crisis/keeper/keeper.go#L51-L53 reference now points to v0.53.0.


87-87: End-of-block invariants example link updated.
The x/crisis/abci.go#L12-L21 link uses v0.53.0. Looks accurate.

docs/docs/learn/advanced/05-encoding.md (4)

81-81: Transaction encoder/decoder import updated.
The tx_msg.go#L112-L115 link now points to v0.53.0. Confirm the code lines remain accurate.


195-195: Validator struct example updated.
The link to x/staking/types/staking.pb.go#L341-L375 is now on v0.53.0. Looks correct.


200-200: PubKey encoding example updated.
The x/staking/types/validator.go#L43-L64 reference is correctly updated to v0.53.0.


222-230: Switch from anypb to anyutil.
The diff correctly replaces imports and calls to use github.com/cosmos/cosmos-proto/anyutil, ensuring the SDK’s Any handling remains consistent with v0.53.0.

🧰 Tools
🪛 markdownlint-cli2 (0.17.2)

222-222: Hard tabs
Column: 3

(MD010, no-hard-tabs)


223-223: Hard tabs
Column: 2

(MD010, no-hard-tabs)

docs/docs/learn/advanced/08-events.md (3)

69-70: Validated stable tag update for EventManager reference.

The Go reference link has been correctly updated to point to the v0.53.0 tag in types/events.go.


77-78: Validated stable tag update for EmitTypedEvent reference.

The Go reference link for the EmitTypedEvent method correctly targets v0.53.0 in types/events.go.


128-128: Validated stable tag update for NFT event proto reference.

The event.proto link now correctly points to v0.53.0 in proto/cosmos/nft/v1beta1/event.proto.

docs/docs/build/building-modules/03-msg-services.md (6)

27-28: Validated update to stable tag for generated MsgServer interface.

Link updated to v0.53.0 in x/bank/types/tx.pb.go#L538-L556.


33-34: Validated update to stable tag for Keeper-based msgServer struct.

Link updated to v0.53.0 in x/bank/keeper/msg_server.go#L17-L19.


39-40: Validated update to stable tag for UnwrapSDKContext usage.

Link updated to v0.53.0 in x/bank/keeper/msg_server.go#L56.


98-100: Validated update to stable tag for WrapServiceResult implementation.

Link updated to v0.53.0 in baseapp/msg_service_router.go#L208.


104-105: Validated update to stable tag for ABCI protobuf definitions.

Link updated to v0.53.0 in proto/cosmos/base/abci/v1beta1/abci.proto#L90-L106.


118-119: Validated update to stable tag for telemetry example in vesting module.

Link updated to v0.53.0 in x/auth/vesting/msg_server.go#L79-L90.

x/distribution/README.md (5)

177-178: Validated update to stable tag for FeePool protobuf reference.

Link now points to v0.53.0 in proto/cosmos/distribution/v1beta1/distribution.proto#L117-L124.


222-224: Validated update to stable tag for Params protobuf reference.

Link now points to v0.53.0 in proto/cosmos/distribution/v1beta1/distribution.proto#L12-L38.


358-361: Validated update to stable tag for MsgSetWithdrawAddress response.

Link now points to v0.53.0 in proto/cosmos/distribution/v1beta1/tx.proto#L60-L69.


410-412: Validated update to stable tag for MsgWithdrawDelegatorReward response.

Link now points to v0.53.0 in proto/cosmos/distribution/v1beta1/tx.proto#L76-L85.


487-489: Validated update to stable tag for MsgUpdateParams protobuf reference.

Link now points to v0.53.0 in proto/cosmos/distribution/v1beta1/tx.proto#L146-L158.

x/feegrant/README.md (7)

37-39: Validated update to stable tag for FeeAllowance protobuf reference.

Link updated to v0.53.0 in proto/cosmos/feegrant/v1beta1/feegrant.proto#L86-L94.


60-61: Validated update to stable tag for BasicAllowance protobuf reference.

Link updated to v0.53.0 in proto/cosmos/feegrant/v1beta1/feegrant.proto#L13-L25.


74-75: Validated update to stable tag for PeriodicAllowance protobuf reference.

Link updated to v0.53.0 in proto/cosmos/feegrant/v1beta1/feegrant.proto#L37-L66.


92-93: Validated update to stable tag for AllowedMsgAllowance protobuf reference.

Link updated to v0.53.0 in proto/cosmos/feegrant/v1beta1/feegrant.proto#L72-L81.


104-105: Validated update to stable tag for client/cmd.go FeeGranter flag.

Link updated to v0.53.0 in client/cmd.go#L252-L261.


112-113: Validated update to stable tag for tx builder in auth module.

Link updated to v0.53.0 in x/auth/tx/builder.go#L356-L363.


116-117: Validated update to stable tag for tx proto definitions.

Link updated to v0.53.0 in proto/cosmos/tx/v1beta1/tx.proto#L221-L239.

docs/docs/build/building-modules/02-messages-and-queries.md (3)

37-38: Validated update to stable tag for Msg service protobuf reference.

Link updated to v0.53.0 in proto/cosmos/bank/v1beta1/tx.proto#L13-L32.


101-102: Validated update to stable tag for auth Query service protobuf reference.

Link updated to v0.53.0 in proto/cosmos/auth/v1beta1/query.proto#L12-L78.


136-137: Validated update to stable tag for store queries reference.

Link updated to v0.53.0 in baseapp/abci.go#L1050-L1074.

docs/docs/build/building-apps/01-app-go-di.md (6)

32-33: Updated GitHub reference to stable v0.53.0 for app_config.go.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.


38-39: Updated GitHub reference to stable v0.53.0 for app_di.go.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.


47-48: Updated GitHub reference to stable v0.53.0 for app_config.go runtime configuration.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.


55-56: Updated GitHub reference to stable v0.53.0 for module wiring in app_config.go.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.


61-62: Updated GitHub reference to stable v0.53.0 for app_config.go tx wiring.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.


114-115: Updated GitHub reference to stable v0.53.0 for complete app_di.go snippet.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.

docs/docs/learn/beginner/04-gas-fees.md (3)

29-30: Updated GitHub reference to stable v0.53.0 for gas.go.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.


87-88: Updated GitHub reference to stable v0.53.0 for tx_msg.go.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.


93-94: Updated GitHub reference to stable v0.53.0 for tx.proto.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.

docs/docs/build/building-modules/15-depinject.md (7)

42-43: Updated GitHub reference to stable v0.53.0 for app_config.go snippet.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.


51-52: Updated GitHub reference to stable v0.53.0 for generated Pulsar code.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.


70-71: Updated GitHub reference to stable v0.53.0 for module import in module.go.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.


77-78: Updated GitHub reference to stable v0.53.0 for init providers in module.go.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.


83-84: Updated GitHub reference to stable v0.53.0 for AppModule interface implementation.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.


95-96: Updated GitHub reference to stable v0.53.0 for module input struct in module.go.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.


102-103: Updated GitHub reference to stable v0.53.0 for module output struct in module.go.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.

docs/docs/build/building-modules/14-simulator.md (8)

51-52: Updated GitHub reference to stable v0.53.0 for simsx/runner.go L223–L234.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.


59-59: Updated inline link to stable v0.53.0 for simsx/runner.go L330–L339.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.


65-67: Updated example implementation links to stable v0.53.0 for weighted operations and proposals.
All three list items now point to the v0.53.0 tag with adjusted line numbers.

🧰 Tools
🪛 LanguageTool

[uncategorized] ~65-~65: Loose punctuation mark.
Context: ... - HasWeightedOperationsXWithProposals: [x/gov](https://github.com/cosmos/cosmo...

(UNLIKELY_OPENING_PUNCTUATION)


76-76: Updated GitHub reference to stable v0.53.0 for x/bank/module.go store decoders.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.


115-115: Updated GitHub reference to stable v0.53.0 for distribution module message factories.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.


139-139: Updated GitHub reference to stable v0.53.0 for simapp/app.go simulation manager setup.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.


159-159: Updated GitHub reference to stable v0.53.0 for simsx/runner.go L69–L88.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.


175-175: Updated GitHub reference to stable v0.53.0 for simapp/sim_test.go example.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.

x/authz/README.md (12)

44-44: Updated GitHub reference to stable v0.53.0 for authorizations.go.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.


56-56: Updated protobuf reference to stable v0.53.0 for authz.proto GenericAuthorization.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.


60-60: Updated Go reference to stable v0.53.0 for generic_authorization.go.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.


73-73: Updated protobuf reference to stable v0.53.0 for SendAuthorization.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.


77-77: Updated Go reference to stable v0.53.0 for send_authorization.go.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.


88-88: Updated protobuf reference to stable v0.53.0 for staking module authz.proto.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.


92-92: Updated Go reference to stable v0.53.0 for x/staking/types/authz.go.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.


112-112: Updated protobuf reference to stable v0.53.0 for authz.proto Grant.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.


130-130: Updated Go reference to stable v0.53.0 for keeper/keys.go GrantQueue.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.


145-145: Updated protobuf reference to stable v0.53.0 for tx.proto MsgGrant.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.


160-160: Updated protobuf reference to stable v0.53.0 for tx.proto MsgRevoke.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.


175-175: Updated protobuf reference to stable v0.53.0 for tx.proto MsgExec.
The link now correctly points to the v0.53.0 tag with adjusted line numbers.

x/staking/README.md (9)

97-97: Update protobuf reference for Params to v0.53.0
The URL now correctly points to staking.proto at v0.53.0, lines 296–318.


160-160: Update protobuf reference for Validator struct to v0.53.0
The link correctly reflects staking.proto in v0.53.0, lines 82–135.


164-164: Update protobuf reference for Validator enum to v0.53.0
The URL accurately points to staking.proto v0.53.0, lines 29–78.


180-180: Update protobuf reference for Delegation to v0.53.0
Link updated to staking.proto v0.53.0, lines 191–208.


228-228: Update protobuf reference for UnbondingDelegation to v0.53.0
Correctly points to staking.proto v0.53.0, lines 210–249.


270-270: Update protobuf reference for Redelegation to v0.53.0
Now references staking.proto v0.53.0, lines 253–294.


294-294: Update protobuf reference for UnbondingDelegationQueue to v0.53.0
Link updated to staking.proto v0.53.0, lines 157–166.


305-305: Update protobuf reference for RedelegationQueue to v0.53.0
URL now points to staking.proto v0.53.0, lines 173–184.


326-326: Update go reference for HistoricalInfo to v0.53.0
The link correctly references staking.proto v0.53.0, lines 17–24.

x/gov/README.md (10)

174-174: Update weighted vote protobuf reference to v0.53.0
Link now points to gov.proto in v1beta1 at v0.53.0, lines 32–44.


178-178: Update weighted vote options protobuf reference to v0.53.0
Correctly references gov.proto in v1beta1 at v0.53.0, lines 178–195.


188-188: Update go reference for custom vote calculation to v0.53.0
Now links to tally.go v0.53.0, lines 15–24.


327-327: Update protobuf reference for Proposal to v1 in v0.53.0
Link correctly points to gov.proto v1 at v0.53.0, lines 50–86.


375-375: Update protobuf reference for DepositParams to v0.53.0
URL now references gov.proto v1 at v0.53.0, lines 160–169.


381-381: Update protobuf reference for VotingParams to v0.53.0
Link updated to gov.proto v1 at v0.53.0, lines 172–176.


387-387: Update protobuf reference for TallyParams to v0.53.0
Correctly points to gov.proto v1 at v0.53.0, lines 183–193.


556-556: Update tx reference for MsgSubmitProposal to v0.53.0
Link now points to tx.proto in v1 at v0.53.0, lines 57–78.


586-586: Update tx reference for MsgDeposit to v0.53.0
URL correctly references tx.proto v1 at v0.53.0, lines 155–165.


605-605: Update tx reference for MsgVote to v0.53.0
Link updated to tx.proto v1 at v0.53.0, lines 111–123.

@@ -90,7 +90,7 @@ Since a module can have multiple collections, the following is expected:
We don't want a collection to write over the state of the other collection so we pass it a prefix, which defines a storage
partition owned by the collection.

If you already built modules, the prefix translates to the items you were creating in your ``types/keys.go`` file, example: https://github.com/cosmos/cosmos-sdk/blob/v0.52.0-rc.1/x/feegrant/key.go#L16~L22
If you already built modules, the prefix translates to the items you were creating in your ``types/keys.go`` file, example: https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/x/feegrant/key.go#L25~L22
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

Invalid GitHub link syntax: reversed line range and tilde used
The example link uses #L25~L22, which is not a valid GitHub line range and the start/end lines appear reversed. It should use a hyphen and correct ordering, e.g.: #L22-L25.

Apply this diff to correct it:

- example: https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/x/feegrant/key.go#L25~L22
+ example: https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/x/feegrant/key.go#L22-L25
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
If you already built modules, the prefix translates to the items you were creating in your ``types/keys.go`` file, example: https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/x/feegrant/key.go#L25~L22
If you already built modules, the prefix translates to the items you were creating in your ``types/keys.go`` file, example: https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/x/feegrant/key.go#L22-L25
🤖 Prompt for AI Agents (early access)
In collections/README.md at line 93, the GitHub link uses an invalid line range syntax with reversed line numbers and a tilde. Correct the link by replacing `#L25~L22` with a valid range using a hyphen and proper order, such as `#L22-L25`.

Comment on lines 108 to 109
https://github.com/cosmos/cosmos-sdk/blob/v0.47.0-rc1/client/tx/tx.go#L109-L109
```
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

Outdated link detected: old release-candidate reference remains.

The Go reference in client/tx/tx.go still points to v0.47.0-rc1. It should be updated to the corresponding v0.53.0 location.

🤖 Prompt for AI Agents (early access)
In x/feegrant/README.md around lines 108 to 109, update the outdated Go reference link from version v0.47.0-rc1 to the correct v0.53.0 version. Replace the old release-candidate URL with the stable release URL pointing to the same file path in the v0.53.0 tag.

@aljo242 aljo242 force-pushed the chore/docs-fixington branch from 783bee6 to f2efc1e Compare May 6, 2025 19:11
https://github.com/cosmos/cosmos-sdk/blob/v0.47.0-rc1/proto/cosmos/staking/v1beta1/tx.proto#L78-L97
https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/proto/cosmos/staking/v1beta1/tx.proto#L79-L95
Copy link
Contributor

Choose a reason for hiding this comment

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

borked

https://github.com/cosmos/cosmos-sdk/blob/v0.47.0-rc1/proto/cosmos/staking/v1beta1/tx.proto#L154-L158
https://github.com/cosmos/cosmos-sdk/blob/v0.53.0/proto/cosmos/staking/v1beta1/tx.proto#L154-L158
Copy link
Contributor

Choose a reason for hiding this comment

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

borked

@aljo242 aljo242 assigned aljo242 and unassigned aljo242 May 8, 2025
@aljo242 aljo242 marked this pull request as draft May 12, 2025 19:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants