ITADN

docs: clarify partial scoring logic in Branch-Protection tiered requirements

#5009Closedaban-alazzeh 创建于 2026-04-08
A
aban-alazzehcommented
**Problem Description** The current documentation implies an all or nothing approach to tiers: "This test has tiered scoring. Each tier must be fully satisfied to achieve points at the next tier. For example, if you fulfill the Tier 3 checks but do not fulfill all the Tier 2 checks, you will not receive any points for Tier 3." This leads users to believe that if they miss one requirement in Tier 2, they will only receive the 3 points from Tier 1. However, the implementation in checks/evaluation/branch_protection.go uses normalizeScore to award partial credit for each passed requirement within the current tier. **Proposed Change** Update the wording in docs/checks/internal/checks.yaml to accurately reflect that while you can't jump to a higher tier without finishing the current one, you do get points for your progress within the tier. Suggested wording: "This test has tiered scoring. You receive partial credit for requirements met within your current tier. However, a tier must be fully satisfied before you can earn points from the next tier. For example, if you fulfill the Tier 3 checks but do not fulfill all the Tier 2 checks, you will not receive any points for Tier 3."
关闭于 2026-04-23 0 条评论