# "How It Works" / Under-the-Hood page (DRAFT — not built)

Status: **draft copy, parked 2026-06-06.** Mike likes the idea in theory, not
yet sold on the words. Revisit + refine before building. Tracked in TODO.md.

## Why this page
Turn "trust our stock data" into something a visitor can believe, while doubling
as evergreen, indexable **E-E-A-T / trust content** that separates ARPartsFinder
from thin price-scrapers. Supports the [[growth-thesis-wikiarms-benchmark]]
positioning (serious, well-engineered comparison engine) and the
[[positioning-comparison-engine-not-retailer]] line. The invisible infra
(SQL perf, bot-filtered metrics, restock-latency scanning, zero-downtime
deploys) shows up here as *why the site is trustworthy and fast*, not as a
feature list.

## Route
`/how-it-works` (clean slug; linkable from the footer + `/about`). New site-ng
view + template + sitemap entry + footer link.

## Voice / rules
Plain, confident, builder-to-builder. No jargon. **No em-dashes** (on-page copy;
[[feedback-no-emdash]]). ARPartsFinder one word. Benefit-framed. NEVER expose
scraper internals (scan frequency/tooling), retailer-specific quirks, or
overclaim perfect accuracy.

## Dynamic bits
`[N]` placeholders (retailer count, in-stock parts count) render live from
`category_count` + the retailer list, so the page self-updates and stays honest.

## Caveat baked into the draft
The builds section claims only what is LIVE at launch (plan / save / share).
**Restock + price-drop alerts are deliberately omitted** ([[feature-site-price-watches]],
[[feature-oos-browse-and-restock-watches]] are roadmap) — a trust page can't
promise a feature that doesn't work yet. Add a "Let us watch it for you" section
the day those ship.

---

## Draft copy

# How ARPartsFinder Works

ARPartsFinder is a live search for AR-15 and AR-10 parts. We track what's in
stock across [N] US retailers, show you the current price, and send you straight
to whoever actually has it. We don't sell anything ourselves. We help you find
it, fast.

### It started with a shortage
We built ARPartsFinder in 2013, in the middle of a parts and ammo crunch.
Anything worth having was sold out, and finding it meant refreshing a dozen
retailer sites by hand, hoping to catch a restock before it disappeared again.

So we made one place that watches those retailers for you and flags the moment
something comes back. More than a decade later, that is still the entire idea:
catch the restock, skip the manual refreshing, get back to building.

### "In stock" means in stock right now
When a part shows as in stock here, it is based on current data, not a snapshot
from last week. We re-check retailer catalogs continuously and pick up restocks
quickly, often within minutes of a product returning.

That speed is the whole point. In a crunch, the gap between "in stock an hour
ago" and "in stock right now" is the difference between the part being in your
cart at checkout or gone.

### Real prices, straight to the source
We show the actual price and stock each retailer is listing, and link you
directly to their product page to buy. We are not a storefront and we never mark
anything up. You always buy from the retailer, at their price.

When you buy through one of our links, the retailer pays us a small commission.
It costs you nothing, and it is what keeps the site online and the scanners
running. We would rather say that plainly than hide it.

### Both platforms, every part
AR-15 and AR-10, from stripped lowers and complete uppers to barrels, bolt
carrier groups, triggers, handguards, optics, and the little parts that always
end up holding a build hostage. If it is an AR part and a US retailer has it in
stock, odds are good you will find it here.

Right now we are tracking [N] in-stock parts across [N] retailers.

### Plan a build, share the link
You can do more than search one part at a time. Spec a full build, save it, and
share the link with a buddy or drop it in a forum thread. It is the quickest way
to put a parts list together and get a second set of eyes on it.

### Independent, and not going anywhere
ARPartsFinder has run since 2013, built and maintained by people who build ARs
too. We are independent. No retailer owns us or decides what we show. Our only
job is helping you find the part.

**[ Browse what's in stock ]  [ Start a build ]**

---

## Open questions for the revisit
- Origin-story angle: lean in (authentic, E-E-A-T) or play down? (Mike undecided.)
- Length / salesiness dial.
- Whether the live `[N]` snapshot is its own band or inline (drafted inline).
- Footer-link label ("How it works" vs "About" merge).
