Skip to content

Conversation

@melekes
Copy link
Contributor

@melekes melekes commented Jun 30, 2025

This pull request updates the ABCI documentation links across multiple files in the cometbft/src/abci/doc directory to point to the latest version (v1.0) of the CometBFT documentation. Additionally, it adds version-specific notes for methods that are only applicable to CometBFT versions prior to v0.38.0.

@melekes melekes added the documentation Improvements or additions to documentation label Jun 30, 2025
@melekes melekes self-assigned this Jun 30, 2025
@melekes melekes requested a review from Copilot June 30, 2025 09:10
Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

This PR updates the ABCI documentation links across the CometBFT ABCI docs to reference the latest v1.0 documentation. It also adds version-specific notes for methods that are only applicable for CometBFT versions prior to v0.38.0.

Reviewed Changes

Copilot reviewed 38 out of 38 changed files in this pull request and generated no comments.

Show a summary per file
File Description
cometbft/src/abci/doc/response-verifyvoteextension.md Updated ABCI documentation link from v0.38.x GitHub reference to v1.0 docs.
cometbft/src/abci/doc/response-query.md Updated ABCI docs link to v1.0; note potential URL structure change for the query endpoint.
cometbft/src/abci/doc/response-processproposal.md Updated ABCI docs link from v0.37.x to v1.0.
cometbft/src/abci/doc/response-prepareproposal.md Updated ABCI docs link from v0.37.x to v1.0.
cometbft/src/abci/doc/response-offersnapshot.md Updated both the primary ABCI docs link and the state sync (ssd) link to v1.0.
cometbft/src/abci/doc/response-loadsnapshotchunk.md Updated ABCI docs link to v1.0.
cometbft/src/abci/doc/response-listsnapshots.md Updated ABCI docs link to v1.0.
cometbft/src/abci/doc/response-initchain.md Updated ABCI docs link to v1.0.
cometbft/src/abci/doc/response-info.md Updated ABCI docs link to v1.0.
cometbft/src/abci/doc/response-flush.md Updated ABCI docs link to v1.0.
cometbft/src/abci/doc/response-finalizeblock.md Updated ABCI docs link from v0.38.x GitHub reference to v1.0.
cometbft/src/abci/doc/response-extendvote.md Updated ABCI docs link from v0.38.x GitHub reference to v1.0.
cometbft/src/abci/doc/response-endblock.md Added a version-specific note and updated the ABCI docs link to reference v0.37 for backwards compatibility.
cometbft/src/abci/doc/response-echo.md Updated ABCI docs link to v1.0.
cometbft/src/abci/doc/response-delivertx.md Added a version-specific note and updated the ABCI docs link to v0.37 for pre-v0.38 methods.
cometbft/src/abci/doc/response-commit.md Updated ABCI docs link to v1.0.
cometbft/src/abci/doc/response-checktx.md Updated ABCI docs link to v1.0.
cometbft/src/abci/doc/response-beginblock.md Added a version-specific note and updated the ABCI docs link to v0.37 for pre-v0.38 methods.
cometbft/src/abci/doc/response-applysnapshotchunk.md Updated ABCI docs link to v1.0.
cometbft/src/abci/doc/request-verifyvoteextension.md Updated ABCI docs link from v0.38.x GitHub reference to v1.0.
cometbft/src/abci/doc/request-query.md Updated ABCI docs link to v1.0; review the URL pattern for consistency with endpoint updates.
cometbft/src/abci/doc/request-processproposal.md Updated ABCI docs link from v0.37.x to v1.0.
cometbft/src/abci/doc/request-prepareproposal.md Updated ABCI docs link from v0.37.x to v1.0.
cometbft/src/abci/doc/request-offersnapshot.md Updated both the primary ABCI docs link and the ssd reference to v1.0.
cometbft/src/abci/doc/request-loadsnapshotchunk.md Updated ABCI docs link to v1.0.
cometbft/src/abci/doc/request-listsnapshots.md Updated ABCI docs link to v1.0.
cometbft/src/abci/doc/request-initchain.md Updated ABCI docs link to v1.0.
cometbft/src/abci/doc/request-info.md Updated ABCI docs link to v1.0.
cometbft/src/abci/doc/request-flush.md Updated ABCI docs link to v1.0.
cometbft/src/abci/doc/request-finalizeblock.md Updated ABCI docs link from v0.38.x GitHub reference to v1.0.
cometbft/src/abci/doc/request-extendvote.md Updated ABCI docs link from v0.38.x GitHub reference to v1.0.
cometbft/src/abci/doc/request-endblock.md Added a version-specific note and updated the ABCI docs link to reference v0.37 for pre-v0.38 methods.
cometbft/src/abci/doc/request-echo.md Updated ABCI docs link to v1.0.
cometbft/src/abci/doc/request-delivertx.md Added a version-specific note and updated the ABCI docs link to v0.37 for pre-v0.38 methods.
cometbft/src/abci/doc/request-commit.md Updated ABCI docs link to v1.0.
cometbft/src/abci/doc/request-checktx.md Updated ABCI docs link to v1.0.
cometbft/src/abci/doc/request-beginblock.md Added a version-specific note and updated the ABCI docs link to v0.37 for pre-v0.38 methods.
cometbft/src/abci/doc/request-applysnapshotchunk.md Updated ABCI docs link to v1.0.
Comments suppressed due to low confidence (3)

cometbft/src/abci/doc/response-query.md:3

  • Verify that the updated URL for the 'query' endpoint using 'abci++_methods' is correct for v1.0 documentation, as the query endpoint might follow a different URL structure.
[ABCI documentation](https://docs.cometbft.com/v1.0/spec/abci/abci++_methods#query)

cometbft/src/abci/doc/response-endblock.md:3

  • Confirm that the version-specific note and the accompanying documentation link (pointing to v0.37) for 'endblock' correctly reflect the intended backward compatibility and documentation structure.
**This is only called by CometBFT prior to version v0.38.0.**

cometbft/src/abci/doc/response-delivertx.md:4

  • Ensure that the version-specific note and the updated documentation link (targeting v0.37) for 'delivertx' align with the intended use of this endpoint in pre-v0.38 versions.
**This is only called by CometBFT prior to version v0.38.0.**

@melekes melekes mentioned this pull request Jun 30, 2025
7 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants