docs: stop presenting Threadripper 68+68=137 W as a correct RAPL sum

[Dmao233]

Description

docs/explanation/rapl.md showed the Threadripper 1950X teaser

package-0-die-0: 68 W | package-0-die-1: 68 W | CodeCarbon: 137 W

with no note that those two dies can report the same socket-wide RAPL counter. That line was easy to read as confirmed-correct behaviour. It is the double-count discussed in mlco2#1274 / mlco2#1276 / mlco2#1379: one meter read twice, so the CPU RAPL value is ~68 W, not 137 W.

This PR only annotates the docs. It does not implement Linux RAPL deduplication (that remains mlco2#1276).

Changes in docs/explanation/rapl.md:

• Mark the 68 W + 68 W = 137 W teaser as the known over-count.
• Note mirrored per-die packages next to the existing hierarchy double-count explanation.
• Qualify the AMD bullets that told readers to sum every package-X-die-Y domain.
• Distinguish the later Threadripper capture, which exposes a single package-0 (kernel-dependent).

Related Issue

Fixes mlco2#1392

Related: mlco2#1274, mlco2#1276, mlco2#1379

Motivation and Context

Readers were being taught that summing two identical 68 W die readings is the right RAPL result. Whatever lands in mlco2#1276, that example should not stay unannotated.

How Has This Been Tested?

• Confirmed no open complete PR already targets docs: rapl.md presents the Threadripper 68+68 = 137 W sum as correct mlco2/codecarbon#1392. fix: deduplicate mirrored Linux RAPL counters mlco2/codecarbon#1276 updates a different AMD bullet and claims a code fix; it does not annotate this example.
• Read the current docs/explanation/rapl.md against Linux RAPL over-counts CPU power on multi-die CPUs (port the Windows EMI fix) mlco2/codecarbon#1274 / Linux RAPL may double-count CPU power on multi-die AMD, while Windows EMI explicitly guards against it mlco2/codecarbon#1379 so the note matches the mirrored-counter explanation, not hierarchical psys/package overlap.
• Checked that !!! warning is already used in this docs set.
• Built the docs: uv run --only-group doc task docs — "No issues found", link check passed. The rendered RAPL page includes the WRONG: 68 W + 68 W = 137 W annotation and the "Mirrored per-die RAPL counters" admonition.

Screenshots (if appropriate):

Not applicable (docs-only).

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)

AI Usage Disclosure

• 🟥 AI-vibecoded: You cannot explain the logic. Car analogy : the car drive by itself, you are outside it and just tell it where to go.
• 🟠 AI-generated: Car analogy : the car drive by itself, you are inside and give instructions.
• ⭐ AI-assisted. Car analogy : you drive the car, AI help you find your way.
• ♻️ No AI used. Car analogy : you drive the car.

Checklist:

• My code follows the code style of this project.
• My change requires a change to the documentation.
• I have updated the documentation accordingly.
• I have read the docs/how-to/contributing.md document.
• I have added tests to cover my changes.
• All new and existing tests passed.

This branch lives on the fork. To open the intended PR against upstream:

gh pr create --repo mlco2/codecarbon \
  --head Dmao233:cursor/fix-rapl-docs-double-count-622a \
  --base master \
  --title "docs: stop presenting Threadripper 68+68=137 W as a correct RAPL sum"