Skip to content

Commit a857707

Browse files
docs: Add documentation for CI workflow
- Documented the current CI workflow - Added diagram for better visualization Signed-off-by: Shamitha Shashidhara <[email protected]> Change-Id: Ib91bc654606bd002f36757426cdebc12d85e9807
1 parent 5997a95 commit a857707

File tree

2 files changed

+24
-0
lines changed

2 files changed

+24
-0
lines changed

.github/workflows/README.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
# Github Workflows
2+
3+
## Overview
4+
5+
![gh_actions.drawio.png](gh_actions.drawio.png)
6+
7+
To ensure a stable main branch, we verify PRs (Pull Requests) once they are created or updated and again when they are accepted. Therefore, each verification workflow needs to have pull_request set in the trigger conditions. Please refer to the above diagram to clearly understand the workflow of our CI.
8+
9+
## General guidelines
10+
11+
1. Don't waste compute time.
12+
2. Each job should have a specific purpose.
13+
3. Each artifact produced should make sense on its own.
14+
4. Don't rely on a different job running afterwards.
15+
5. Each job should have a unique name.
16+
17+
18+
## PR Verification Process
19+
20+
1. Code Review: Reviewers check for code quality, functionality, and adherence to coding standards.
21+
2. Automated Checks: The CI workflows run automated checks, including builds, tests, format_check, code coverage, and documentation generation.
22+
3. Manual Testing: Reviewers perform manual testing if necessary to verify functionality.
23+
4. Approval and Merge: Once the PR passes all checks and reviews, it can be approved and merged into the main branch.
24+
5. Post-Merge Verification: Monitor the CI pipeline to ensure the merge does not introduce any issues.
168 KB
Loading

0 commit comments

Comments
 (0)