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

docs: Updated documentation to incorporate CITR & Semantic Release #17327

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

Conversation

rbarkerSL
Copy link
Contributor

Description:
Updates documentation to incorporate Semantic Release, XTS build tags, and the new release process

Signed-off-by: Roger Barker <roger.barker@swirldslabs.com>
@rbarkerSL rbarkerSL linked an issue Jan 10, 2025 that may be closed by this pull request
@rbarkerSL
Copy link
Contributor Author

Targets release 0.59

@rbarkerSL rbarkerSL added this to the v0.59 milestone Jan 10, 2025
@rbarkerSL rbarkerSL added the Release Issues tied to release management functions. label Jan 10, 2025
@rbarkerSL rbarkerSL self-assigned this Jan 10, 2025
@rbarkerSL rbarkerSL requested a review from AliNik4n January 10, 2025 21:44
Copy link

codecov bot commented Jan 10, 2025

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 67.41%. Comparing base (50747ad) to head (6aee29c).

Additional details and impacted files

Impacted file tree graph

@@            Coverage Diff            @@
##               main   #17327   +/-   ##
=========================================
  Coverage     67.41%   67.41%           
- Complexity    22092    22093    +1     
=========================================
  Files          2588     2588           
  Lines         96595    96595           
  Branches      10087    10087           
=========================================
+ Hits          65118    65119    +1     
  Misses        27751    27751           
+ Partials       3726     3725    -1     

see 1 file with indirect coverage changes

Impacted file tree graph

Copy link

codacy-production bot commented Jan 10, 2025

Coverage summary from Codacy

See diff coverage on Codacy

Coverage variation Diff coverage
+0.00% (target: -1.00%)
Coverage variation details
Coverable lines Covered lines Coverage
Common ancestor commit (50747ad) 96378 68692 71.27%
Head commit (6aee29c) 96378 (+0) 68692 (+0) 71.27% (+0.00%)

Coverage variation is the difference between the coverage for the head and common ancestor commits of the pull request branch: <coverage of head commit> - <coverage of common ancestor commit>

Diff coverage details
Coverable lines Covered lines Diff coverage
Pull request (#17327) 0 0 ∅ (not applicable)

Diff coverage is the percentage of lines that are covered by tests out of the coverable lines that the pull request added or modified: <covered lines added or modified>/<coverable lines added or modified> * 100%

See your quality gate settings    Change summary preferences

Codacy stopped sending the deprecated coverage status on June 5th, 2024. Learn more

Signed-off-by: Roger Barker <roger.barker@swirldslabs.com>
Signed-off-by: Roger Barker <roger.barker@swirldslabs.com>

### Relevant CITR Background

The continuous integration test and release process has been being executed within Hedera-Services since Q3-2023.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
The continuous integration test and release process has been being executed within Hedera-Services since Q3-2023.
The continuous integration test and release (CITR) process has been being executed within Hedera-Services since Q3-2024.


## CITR Release Process

The release process will be changing in the following areas beginning with `Release 0.59`
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
The release process will be changing in the following areas beginning with `Release 0.59`
The release process will be changing in the following areas beginning with `Release 0.59`:


The release managers will pull a release candidate from this set of tags.

The release managers will run `zxf-trigger-semantic-release`, specifying the build number, in order to create the
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
The release managers will run `zxf-trigger-semantic-release`, specifying the build number, in order to create the
The release managers will run the workflow `zxf-trigger-semantic-release`, specifying the build number, in order to create the

- Creating release branches in `hedera-services` (like release/0.59)
- Creating versioned tags like (v0.59.*)
- The following workflows will be added:
- `zxf-trigger-semantic-release` - Generate a release tag given an XTS passing build id
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
- `zxf-trigger-semantic-release` - Generate a release tag given an XTS passing build id
- `zxf-trigger-semantic-release` - Generate a release tag given an XTS passing build id.

- `zxf-version-roll` - Roll the version specified in `version.txt` for the current development cycle on the default
branch.
- Release management will need to choose a build candidate from a list of associated builds (recommendation will be the
latest `build-xxxxx` tag)
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
latest `build-xxxxx` tag)
latest `build-xxxxx` tag).

| **milestone** Deploy to main net | 7d |
| Release Retrospective | 1d |

Each release takes approximately one calendar quarter to complete (from planning to retrospective)
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
Each release takes approximately one calendar quarter to complete (from planning to retrospective)
Each release takes approximately one calendar quarter to complete (from planning to retrospective).

### Historical Process

The release process within hedera-services has been using a release branching strategy that follows
a set development cycle
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
a set development cycle
a set development cycle:


### Historical Process

The release process within hedera-services has been using a release branching strategy that follows
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
The release process within hedera-services has been using a release branching strategy that follows
The release process within Hedera-Services has been using a release branching strategy that follows

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Release Issues tied to release management functions.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Add release process documentation
2 participants