Document CRN-specific scoring rules - #82
Conversation
Add an "Additional rules for Compute Resource Nodes" section to the scoring page covering the CRN-only checks: IP stability (static IPv4/IPv6 and a limit of 2 address changes over a rolling 30-day window, with IPv6 keyed to the VM address pool), one scored node per machine (duplicate IPv4/IPv6-pool handling), and liveness status (active/inactive/dead). Include the diagnostic code table and a note that the rules are rolled out progressively with warning codes before they affect the score.
|
Deployed on:
|
foxpatch-aleph
left a comment
There was a problem hiding this comment.
This PR adds a well-structured, clearly written section documenting CRN-specific scoring rules. The diagnostic code table is complete and maps correctly to the rules described in the text. Internal links and anchors are valid, terminology (IPV6_ADDRESS_POOL, /status/config) is consistent with the installation guides, and the VitePress container syntax matches the rest of the docs. The content accurately distinguishes the 30-day rolling IP-stability window from the 2-year performance window, explains the liveness thresholds, and includes appropriate operator-facing warnings about NAT/shared-IP scenarios. No correctness, security, or quality issues found.
docs/nodes/resources/scoring/index.md (line 146): Minor: diagnostic code 1007 ("Not currently proving it is a CRN") corresponds to the "inactive" status, but the Liveness section only states that "dead" nodes get a score of 0. It might help to clarify whether 1007 is purely informational or if it can affect the score during the progressive rollout — an operator seeing this code may wonder if their score is impacted. The top-level info note about warnings covers this implicitly, but an explicit note would reduce support questions.
Adds an Additional rules for Compute Resource Nodes section to the scoring page (
docs/nodes/resources/scoring/index.md), documenting the CRN-only checks that were missing:IPV6_ADDRESS_POOL), not the access address. The window is rolling, so the score recovers as changes age out.An info note states the rules are rolled out progressively, with warning codes published before a rule affects the score.
Notes for reviewers:
IP_STABILITY_WINDOW).