Skip to content

Commit 34d6b08

Browse files
committed
Regroup and reword the research project cards
Order the initiatives by family rather than by date, title them the way the repository does, and give every description one shape. Swap the homepage feature to the measurable mistakes article, and trade descriptions with the WhatKey card so each says what it is actually about. Add store links to the article index CTA.
1 parent d37e333 commit 34d6b08

5 files changed

Lines changed: 63 additions & 42 deletions

File tree

docs/site/public/css/style.css

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1414,7 +1414,8 @@ a.heading-anchor svg {
14141414
color: var(--text-2);
14151415
}
14161416

1417-
.article-cta .cta-secondary {
1417+
.article-cta .cta-secondary,
1418+
.try-teaser-card .cta-secondary {
14181419
margin: 4px 0 0;
14191420
font-size: 0.9rem;
14201421
}

docs/site/src/content/articles/measuring-how-wrong-we-are.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,11 @@ description:
1414
"A plain-English tour of WhatChord’s negative research results, and why
1515
reproducible experiments that stop bad ideas are as valuable as positive
1616
findings."
17+
featuredDescription:
18+
"A frozen protocol, held-out music, and a dated log of every idea that failed:
19+
the discipline that keeps WhatChord’s analysis grounded in measurement rather
20+
than intuition."
21+
featuredOrder: 2
1722
group: "technical"
1823
image: "/images/homepage_social.jpg"
1924
imageAlt: "WhatChord: Identify chords. Understand harmony."

docs/site/src/content/articles/million-chord-annotations.md

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -11,10 +11,6 @@ decks:
1111
description:
1212
"How a large public chord corpus helped validate WhatChord’s chord vocabulary
1313
and guide future recognition priorities."
14-
featuredDescription:
15-
"How a large public chord corpus helped validate WhatChord’s chord vocabulary
16-
and guide future recognition priorities with evidence rather than guesswork."
17-
featuredOrder: 2
1814
group: "technical"
1915
image: "/images/homepage_social.jpg"
2016
imageAlt: "WhatChord: Identify chords. Understand harmony."

docs/site/src/pages/articles/index.astro

Lines changed: 53 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -69,58 +69,58 @@ const technicalArticles = articles.filter(
6969
class="article-card article-card-external"
7070
href="https://github.com/EarthmanMuons/whatchord/tree/main/research/whatkey"
7171
>
72-
<h3>Streaming Key Estimation Research</h3>
72+
<h3>WhatKey</h3>
7373
<p>
74-
The research project behind automatic key detection: a frozen
75-
evaluation protocol, versioned fixtures, external baselines,
76-
dated experiment logs, and held-out results.
74+
Naming the key while the music is still playing, from the chord
75+
recognizer’s output rather than a finished score, and staying
76+
quiet when the evidence is too thin to call.
7777
</p>
7878
<span class="read-more">Read the research notes</span>
7979
</a>
8080
<a
8181
class="article-card article-card-external"
82-
href="https://github.com/EarthmanMuons/whatchord/tree/main/research/chord-context"
82+
href="https://github.com/EarthmanMuons/whatchord/tree/main/research/whatkey-local"
8383
>
84-
<h3>Chord Context Research</h3>
84+
<h3>WhatKey Local</h3>
8585
<p>
86-
The research project testing whether recently played chords, and
87-
the key they imply, sharpen live chord naming, measured against
88-
a strong baseline on two annotated classical corpora.
86+
How closely that detector should follow the brief key changes
87+
inside a piece, and what chasing them costs in the steadiness a
88+
glanceable indicator needs.
8989
</p>
9090
<span class="read-more">Read the research notes</span>
9191
</a>
9292
<a
9393
class="article-card article-card-external"
94-
href="https://github.com/EarthmanMuons/whatchord/tree/main/research/ensemble-mode"
94+
href="https://github.com/EarthmanMuons/whatchord/tree/main/research/chord-context"
9595
>
96-
<h3>Ensemble Mode Research</h3>
96+
<h3>Chord Context</h3>
9797
<p>
98-
An explicit comping mode that names rootless voicings when a
99-
bass player supplies the root, built from a costed handoff and
100-
verified to leave solo analysis untouched.
98+
Whether recently played chords, and the key they imply, sharpen
99+
live chord naming, tested against a strong baseline on two
100+
annotated classical corpora.
101101
</p>
102102
<span class="read-more">Read the research notes</span>
103103
</a>
104104
<a
105105
class="article-card article-card-external"
106-
href="https://github.com/EarthmanMuons/whatchord/tree/main/research/whatkey-local"
106+
href="https://github.com/EarthmanMuons/whatchord/tree/main/research/ensemble-mode"
107107
>
108-
<h3>WhatKey Local Research</h3>
108+
<h3>Ensemble Mode</h3>
109109
<p>
110-
Making the detector’s claimed key match analyst-marked local
111-
keys more often, without giving up the section-key stability the
112-
shipped presets were frozen for.
110+
A comping mode for the voicings a pianist plays over a bass
111+
player, where the root is deliberately absent and the engine
112+
previously had no name for the chord at all.
113113
</p>
114114
<span class="read-more">Read the research notes</span>
115115
</a>
116116
<a
117117
class="article-card article-card-external"
118118
href="https://github.com/EarthmanMuons/whatchord/tree/main/research/ensemble-tiebreak"
119119
>
120-
<h3>Ensemble Tiebreak Research</h3>
120+
<h3>Ensemble Tiebreak</h3>
121121
<p>
122-
Closing the naming errors that remain when the key is already
123-
right, measured on a jazz-comping benchmark built from the
122+
Closing the naming errors that survive when the key is already
123+
correct, measured on a jazz comping benchmark built from the
124124
Weimar Jazz Database.
125125
</p>
126126
<span class="read-more">Read the research notes</span>
@@ -129,19 +129,19 @@ const technicalArticles = articles.filter(
129129
class="article-card article-card-external"
130130
href="https://github.com/EarthmanMuons/whatchord/tree/main/research/performed-input"
131131
>
132-
<h3>Performed Input Research</h3>
132+
<h3>Performed Input</h3>
133133
<p>
134-
Measuring chord identity on real recorded performances through
135-
the live capture path, where every earlier accuracy number had
136-
used clean synthesized voicings.
134+
Scoring chord identity on real recorded performances through the
135+
app’s own input path, where every earlier accuracy number had
136+
rested on clean synthesized voicings.
137137
</p>
138138
<span class="read-more">Read the research notes</span>
139139
</a>
140140
<a
141141
class="article-card article-card-external"
142142
href="https://github.com/EarthmanMuons/whatchord/tree/main/research/tone-pricing"
143143
>
144-
<h3>Tone Pricing Research</h3>
144+
<h3>Tone Pricing</h3>
145145
<p>
146146
What a chord name should pay for a tone it cannot explain, and
147147
what discount an honest incomplete reading deserves: one cost
@@ -157,15 +157,34 @@ const technicalArticles = articles.filter(
157157
<section class="try-teaser">
158158
<div class="wrap">
159159
<div class="try-teaser-card">
160-
<div class="section-label">Try it now</div>
161-
<h2>Identify a chord in your browser.</h2>
160+
<div class="section-label">Free download</div>
161+
<h2>Bring it to your own keyboard.</h2>
162162
<p class="section-sub">
163-
Nothing to install. Type a few notes and the same engine that powers
164-
the app will name the voicing and its close alternatives.
163+
Available for iOS and Android, with no subscription, no ads, and
164+
every analysis running on-device.
165+
</p>
166+
<div class="store-badges store-badges-spaced">
167+
<a href="https://apps.apple.com/us/app/whatchord-midi/id6758409779">
168+
<img
169+
class="store-badge"
170+
src="../images/Download_on_the_App_Store_Badge_US-UK_RGB_blk_092917.svg"
171+
alt="Download on the App Store"
172+
/>
173+
</a>
174+
<a
175+
href="https://play.google.com/store/apps/details?id=com.earthmanmuons.whatchord"
176+
>
177+
<img
178+
class="store-badge"
179+
src="../images/GetItOnGooglePlay_Badge_Web_color_English.svg"
180+
alt="Get it on Google Play"
181+
/>
182+
</a>
183+
</div>
184+
<p class="cta-secondary">
185+
Prefer not to install?{" "}
186+
<a href="/try">Try identifying chords in your browser →</a>
165187
</p>
166-
<a class="btn btn-primary" href="/try">
167-
Open the chord identifier →
168-
</a>
169188
</div>
170189
</div>
171190
</section>

docs/site/src/pages/index.astro

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -370,9 +370,9 @@ const featuredArticles = (await getCollection("articles"))
370370
<div class="article-tag">Key Detection</div>
371371
<h3>Streaming Key Estimation Research</h3>
372372
<p>
373-
The research project behind automatic key detection: a frozen
374-
evaluation protocol, versioned fixtures, external baselines, dated
375-
experiment logs, and held-out results.
373+
Naming the key while the music is still playing, from the chord
374+
recognizer’s output rather than a finished score, and staying
375+
quiet when the evidence is too thin to call.
376376
</p>
377377
<span class="read-more">Read the research notes</span>
378378
</a>

0 commit comments

Comments
 (0)