Skip to content

Commit 42b24fd

Browse files
committed
docs: add "tests outweigh features" pain to homepage, sync README
Mirror the README's three-pain Problem section on the homepage so a visitor sees the same critique in both places: - New pain card on the homepage between "Testing is always last" and "AI writes tests that don't run": title "Tests outweigh features", body "Setup. Mocks. Helpers. You end up writing more code for the tests than for the feature itself. Like shipping a second app." Icon: two file shapes, the larger one in the danger color to convey test code outweighing feature code. - Pain-cards grid: cascade 4 cols → 2 cols (≤1024px) → 1 col (≤768px) so the new four-card row never sits too cramped between breakpoints. - README: drop "harnesses" from the tooling-pain paragraph so the homepage card and the README prose use the same three-item list (setup, mocks, helpers).
1 parent 6acce7d commit 42b24fd

2 files changed

Lines changed: 18 additions & 2 deletions

File tree

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@
1616

1717
Testing gets pushed to next week, and next week never comes. When it does happen, tests usually run in a different environment from where you're building, so testing feels like overhead the moment you finish a feature.
1818

19-
The tooling pushes you the same way. You end up writing more code for the tests than for the feature itself, between setup, harnesses, mocks, and helpers. Adding tests starts to feel like shipping a second app on top of the one you already finished.
19+
The tooling pushes you the same way. You end up writing more code for the tests than for the feature itself, between setup, mocks, and helpers. Adding tests starts to feel like shipping a second app on top of the one you already finished.
2020

2121
As AI writes more of your code, the gap widens. Agents generate test files that look correct but never actually execute in a real browser. The mocks those tests rely on quietly drift from the real API over time. Fields get renamed, mocks stay frozen, tests pass, production breaks.
2222

docs/.vitepress/theme/components/HomePage.vue

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -103,6 +103,16 @@ const faqs = [
103103
The codebase grows. The debt compounds.
104104
</p>
105105
</div>
106+
<div class="pain-card">
107+
<div class="pain-icon">
108+
<svg width="24" height="24" viewBox="0 0 24 24" fill="none" aria-hidden="true"><rect x="3" y="6" width="9" height="13" rx="1.5" stroke="currentColor" stroke-width="2"/><rect x="10" y="3" width="11" height="14" rx="1.5" stroke="var(--hp-danger)" stroke-width="2"/><path d="M13 7h5M13 10h5M13 13h5" stroke="var(--hp-danger)" stroke-width="2" stroke-linecap="round"/></svg>
109+
</div>
110+
<h3 class="pain-title">Tests outweigh features</h3>
111+
<p class="pain-desc">
112+
Setup. Mocks. Helpers. You end up writing more code for the tests
113+
than for the feature itself. Like shipping a second app.
114+
</p>
115+
</div>
106116
<div class="pain-card">
107117
<div class="pain-icon">
108118
<svg width="24" height="24" viewBox="0 0 24 24" fill="none" aria-hidden="true"><rect x="4" y="4" width="16" height="16" rx="2" stroke="currentColor" stroke-width="2"/><path d="M9 9l6 6M15 9l-6 6" stroke="var(--hp-danger)" stroke-width="2" stroke-linecap="round"/></svg>
@@ -472,10 +482,16 @@ const faqs = [
472482
473483
.pain-cards {
474484
display: grid;
475-
grid-template-columns: repeat(3, 1fr);
485+
grid-template-columns: repeat(4, 1fr);
476486
gap: 20px;
477487
}
478488
489+
@media (max-width: 1024px) {
490+
.pain-cards {
491+
grid-template-columns: repeat(2, 1fr);
492+
}
493+
}
494+
479495
.pain-card {
480496
padding: 32px 28px;
481497
border-radius: var(--hp-radius);

0 commit comments

Comments
 (0)