docs: 2025 day 10, part 1

[adomani]

Add the docs and a few small modifications.

[github-actions]

PR summary 2342869

---

Import changes for modified files

No significant changes to the import graph

Import changes for all files

Files	Import difference

---

Declarations diff

- MtoS
- instance : ToString machine
- machine

You can run this locally by cloning adomani/PR_summary and then using `scripts/declarations_diff.sh`.

## summary with just the declaration names:
./scripts/declarations_diff.sh

## more verbose report:
./scripts/declarations_diff.sh -l

Running ./scripts/declarations_diff.sh -h shows the available options.

The doc-module for script/declarations_diff.sh contains some details about this script.

---

Decrease in tech debt: (relative, absolute) = (1.00, 0.00)

Current number	Change	Type
989	-1	definitions

Current commit 2342869ed2
Reference commit c3e46b5f67

You can run this locally as

./scripts/technical-debt-metrics.sh pr_summary

• The relative value is the weighted sum of the differences with weight given by the inverse of the current value of the statistic.
• The absolute value is the relative value divided by the total sum of the inverses of the current values (i.e. the weighted average of the differences).

adomani/advents