Philip Guzman
26 lines
1.1 KiB
Markdown
26 lines
1.1 KiB
Markdown
# Plain-language Diagnostics
|
|
|
|
## Problem
|
|
|
|
“Broken references” combined crate occurrences with Serato's own missing-track
|
|
concept. DJs naturally compared that number with orange/unmapped tracks in Serato,
|
|
even though the two counts describe different layers.
|
|
|
|
## Language
|
|
|
|
- **Missing tracks in Serato** means database entries whose saved file location no
|
|
longer exists. This corresponds most closely to orange or unmapped tracks.
|
|
- **Old crate references** means saved appearances in regular crates whose exact
|
|
filename was not found in the selected music folder. One track can appear in
|
|
several crates, so both appearances and unique filenames are shown.
|
|
|
|
Every health card and diagnostic row has an accessible information button. Hover
|
|
shows its explanation on desktop; click or tap keeps it open; Escape or clicking
|
|
elsewhere closes it. Explanations describe uncertainty and avoid implying repair.
|
|
|
|
## Verification
|
|
|
|
Health tests verify database missing-path and unique-filename counts. Browser tests
|
|
cover the two separate metrics, hover/click explanations, keyboard dismissal, and
|
|
mobile layout.
|