Skip to content
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

chore: move pending-release to release-notes #3988

Merged
merged 8 commits into from
Oct 22, 2024

Conversation

rootulp
Copy link
Collaborator

@rootulp rootulp commented Oct 17, 2024

Also adds a line for node operators to modify their mempool ttl-num-blocks config

@rootulp rootulp self-assigned this Oct 17, 2024
@rootulp rootulp requested review from liamsi and a team as code owners October 17, 2024 18:20
ninabarbakadze
ninabarbakadze previously approved these changes Oct 17, 2024
Copy link
Contributor

coderabbitai bot commented Oct 17, 2024

📝 Walkthrough
📝 Walkthrough

Walkthrough

The changes involve updating the release-notes.md file to reflect the release notes for versions v2.0.0 and v3.0.0 of the celestia-app. This includes modifications to headings to specify version numbers and the addition of new sections detailing requirements for Node Operators and Library Consumers. Additionally, the pending-release.md file has been updated to reflect a new version, changing from "v3.0.0 [Unreleased]" to "v4.0.0" and removing previous content related to Node Operators and Library Consumers.

Changes

File Path Change Summary
docs/release-notes/pending-release.md Updated to reflect version 4.0.0; removed content under Node Operators and Library Consumers.
docs/release-notes/release-notes.md Updated for v2.0.0 and v3.0.0; modified headings to include version numbers; added new sections for Node Operators and Library Consumers detailing new requirements.

Possibly related PRs

  • docs: fix upgrade doc link #3888: This PR updates the release notes document, specifically addressing the link for upgrade heights related to the Lemongrass hardfork, which is also mentioned in the main PR's updates to the release notes for node operators.
  • docs: release-guide link to release notes #3989: This PR enhances the release guide documentation by including a link to the release notes, which is relevant to the changes made in the main PR regarding the structure and content of the release notes.

Suggested labels

backport:v2.x

Suggested reviewers

  • liamsi
  • evan-forbes
  • cmwaters
  • rach-id

📜 Recent review details

Configuration used: .coderabbit.yaml
Review profile: CHILL

📥 Commits

Files that changed from the base of the PR and between f27fc8f and d38b995.

📒 Files selected for processing (2)
  • docs/release-notes/pending-release.md (1 hunks)
  • docs/release-notes/release-notes.md (1 hunks)
🚧 Files skipped from review as they are similar to previous changes (2)
  • docs/release-notes/pending-release.md
  • docs/release-notes/release-notes.md

Thank you for using CodeRabbit. We offer it for free to the OSS community and would appreciate your support in helping us grow. If you find it useful, would you consider giving us a shout-out on your favorite social media?

❤️ 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.

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 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.

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

🧹 Outside diff range and nitpick comments (2)
docs/release-notes/release-notes.md (2)

24-34: LGTM: Valuable information added for v3.0.0-rc0 Node Operators.

The new section provides crucial information for node operators upgrading to v3.0.0-rc0, including:

  1. The requirement to enable the BBR congestion control algorithm.
  2. Instructions for configuring the node's mempool ttl-num-blocks.

These updates are essential for ensuring proper node operation after the upgrade.

Consider enhancing the bash command for better user experience:

- sed -i 's/ttl-num-blocks = 5/ttl-num-blocks = 12/' ~/.celestia-app/config/config.toml
+ sed -i 's/^ttl-num-blocks =.*/ttl-num-blocks = 12/' ~/.celestia-app/config/config.toml

This change makes the command more robust, as it will work regardless of the current ttl-num-blocks value.


35-37: LGTM: Important update for v3.0.0-rc0 Library Consumers.

The new section provides crucial information about the relocation of namespace and share constants to the go-square repository. This is an important change that library consumers need to be aware of.

Consider enhancing this section with more detailed guidance:

  1. Provide the new import path for these constants.
  2. Include a brief code example showing how to use the relocated constants.
  3. Mention any potential breaking changes this relocation might cause and how to address them.

This additional information would help library consumers adapt to the changes more easily.

📜 Review details

Configuration used: .coderabbit.yaml
Review profile: CHILL

📥 Commits

Files that changed from the base of the PR and between 2507aaf and 9383fd3.

📒 Files selected for processing (2)
  • docs/release-notes/pending-release.md (0 hunks)
  • docs/release-notes/release-notes.md (1 hunks)
💤 Files with no reviewable changes (1)
  • docs/release-notes/pending-release.md
🧰 Additional context used
🪛 LanguageTool
docs/release-notes/release-notes.md

[style] ~22-~22: Three successive sentences begin with the same word. Consider rewording the sentence or use a thesaurus to find a synonym.
Context: ...f8d1c60e5511104deed8bc361/inclusion). - celestia-app v1.x had a lot of functionality include...

(ENGLISH_WORD_REPEAT_BEGINNING_RULE)


[style] ~22-~22: Three successive sentences begin with the same word. Consider rewording the sentence or use a thesaurus to find a synonym.
Context: ...f functionality included in the signer. celestia-app v2.x splits a txClient from the signer....

(ENGLISH_WORD_REPEAT_BEGINNING_RULE)

🔇 Additional comments (2)
docs/release-notes/release-notes.md (2)

7-14: LGTM: Improved clarity and added important information for node operators.

The changes in this section enhance the release notes by:

  1. Specifying the version number in the heading, which improves clarity.
  2. Adding crucial information about enabling the BBR congestion control algorithm, which is important for node operators.

These updates provide valuable guidance for node operators upgrading to v2.0.0.


15-23: LGTM: Improved heading clarity.

The update to the heading enhances clarity by specifying the version number (v2.0.0) for Library Consumers.

Note: The static analysis tool flagged repeated sentence beginnings, but in technical documentation, this repetition can actually aid clarity by maintaining a consistent structure. In this case, it's appropriate to keep the current wording.

🧰 Tools
🪛 LanguageTool

[style] ~22-~22: Three successive sentences begin with the same word. Consider rewording the sentence or use a thesaurus to find a synonym.
Context: ...f8d1c60e5511104deed8bc361/inclusion). - celestia-app v1.x had a lot of functionality include...

(ENGLISH_WORD_REPEAT_BEGINNING_RULE)


[style] ~22-~22: Three successive sentences begin with the same word. Consider rewording the sentence or use a thesaurus to find a synonym.
Context: ...f functionality included in the signer. celestia-app v2.x splits a txClient from the signer....

(ENGLISH_WORD_REPEAT_BEGINNING_RULE)

evan-forbes
evan-forbes previously approved these changes Oct 18, 2024

## [v3.0.0-rc0](https://github.com/celestiaorg/celestia-app/releases/tag/v3.0.0-rc0)

### Node Operators (v3.0.0-rc0)
Copy link
Member

Choose a reason for hiding this comment

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

I'd be fine just saying v3.0.0, or all v3.*+ tags or something so we don't have to update this constantly. ie we're going to cut the arabica tag soon

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Agreed, will change

docs/release-notes/release-notes.md Outdated Show resolved Hide resolved
docs/release-notes/release-notes.md Outdated Show resolved Hide resolved
docs/release-notes/release-notes.md Outdated Show resolved Hide resolved
@rootulp rootulp dismissed stale reviews from evan-forbes and ninabarbakadze via ad34bf6 October 18, 2024 20:48
@celestia-bot celestia-bot requested a review from a team October 18, 2024 20:49
@rootulp rootulp enabled auto-merge (squash) October 18, 2024 20:49
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: 0

🧹 Outside diff range and nitpick comments (2)
docs/release-notes/release-notes.md (2)

26-33: LGTM with a minor suggestion: Node Operators section for v3.0.0

The content provides clear and helpful instructions for node operators, which aligns well with the PR objectives. The inclusion of specific commands is particularly useful.

For consistency with the v2.0.0 section, consider updating the heading format:

### Node Operators (v3.0.0)

35-37: LGTM with a minor suggestion: Library Consumers section for v3.0.0

The content provides clear information about changes relevant to library consumers, which aligns well with the PR objectives.

For consistency with the v2.0.0 section, consider updating the heading format:

### Library Consumers (v3.0.0)
📜 Review details

Configuration used: .coderabbit.yaml
Review profile: CHILL

📥 Commits

Files that changed from the base of the PR and between 9383fd3 and f27fc8f.

📒 Files selected for processing (1)
  • docs/release-notes/release-notes.md (1 hunks)
🧰 Additional context used
🪛 LanguageTool
docs/release-notes/release-notes.md

[style] ~22-~22: Three successive sentences begin with the same word. Consider rewording the sentence or use a thesaurus to find a synonym.
Context: ...f8d1c60e5511104deed8bc361/inclusion). - celestia-app v1.x had a lot of functionality include...

(ENGLISH_WORD_REPEAT_BEGINNING_RULE)


[style] ~22-~22: Three successive sentences begin with the same word. Consider rewording the sentence or use a thesaurus to find a synonym.
Context: ...f functionality included in the signer. celestia-app v2.x splits a txClient from the signer....

(ENGLISH_WORD_REPEAT_BEGINNING_RULE)

🔇 Additional comments (3)
docs/release-notes/release-notes.md (3)

7-7: LGTM: Version numbers added to headings

The addition of version numbers to the "Node Operators" and "Library Consumers" headings improves clarity and aligns with the previous review suggestions.

Also applies to: 15-15


24-24: LGTM: New section for v3.0.0 added

The addition of the v3.0.0 section heading is appropriate and consistent with the document structure.


7-37: Overall assessment: Effective update to release notes

The changes to this file successfully incorporate the pending release information for v3.0.0 into the main release notes document. The additions provide clear and helpful information for both node operators and library consumers, aligning well with the PR objectives.

The structure is consistent with the existing format, and the content is informative and well-organized. The minor formatting suggestions for headings, if implemented, will further improve consistency across versions.

Great job on updating the release notes to provide comprehensive guidance for users upgrading to new versions of celestia-app.

🧰 Tools
🪛 LanguageTool

[style] ~22-~22: Three successive sentences begin with the same word. Consider rewording the sentence or use a thesaurus to find a synonym.
Context: ...f8d1c60e5511104deed8bc361/inclusion). - celestia-app v1.x had a lot of functionality include...

(ENGLISH_WORD_REPEAT_BEGINNING_RULE)


[style] ~22-~22: Three successive sentences begin with the same word. Consider rewording the sentence or use a thesaurus to find a synonym.
Context: ...f functionality included in the signer. celestia-app v2.x splits a txClient from the signer....

(ENGLISH_WORD_REPEAT_BEGINNING_RULE)

evan-forbes
evan-forbes previously approved these changes Oct 19, 2024
Copy link
Contributor

@cmwaters cmwaters left a comment

Choose a reason for hiding this comment

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

I would prefer if the latest release was always put at the top.

And we should not remove the pending-release document but rather update it to v4

@celestia-bot celestia-bot requested a review from a team October 21, 2024 12:42
Comment on lines +12 to +14
```bash
sed -i 's/ttl-num-blocks = 5/ttl-num-blocks = 12/' ~/.celestia-app/config/config.toml
```
Copy link
Contributor

Choose a reason for hiding this comment

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

Does this need to be indented?

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

I think desirable for the code block to be indented so it appears under the bullet point that it's related to

Screenshot 2024-10-22 at 11 58 22 AM

@rootulp rootulp merged commit a2f10ed into celestiaorg:main Oct 22, 2024
34 of 35 checks passed
rach-id pushed a commit that referenced this pull request Nov 26, 2024
Also adds a line for node operators to modify their mempool
ttl-num-blocks config

(cherry picked from commit a2f10ed)
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.

4 participants