Skip to content

Resources: content marketplaces, the standards map, and an About page - #77

Merged
EugeneDymo merged 37 commits into
docs/broker-relevancefrom
resources/content-marketplaces
Nov 16, 2026
Merged

EugeneDymo merged 37 commits into
docs/broker-relevancefrom
resources/content-marketplaces

Conversation

@KonstantinMirin

Copy link
Copy Markdown
Contributor

Stacked on #76. Seven new Resources pages on content marketplaces and the standards around them, an About page, the components they're built from, and small consistency changes to existing pages. Website only; no proto change.

Content marketplaces and FORA (/resources/content-marketplaces/). Who pays publishers for AI use of their content today, how each channel works, what it takes on your site, where each is ahead of FORA, and how FORA works beside all of them. A market map of every channel (one table, compact cards on phones), what FORA takes for a revenue team and on a stack, who has shown money moving, how a Broker orders offers, and the eight questions to ask of any channel.

Five deep pages (/resources/content-marketplaces/{tollbit,cloudflare,microsoft-pcm,prorata-gist,perplexity}/). One template: at a glance, the vendor and FORA side by side; how you're paid; who has been paid so far; what it takes on your site (engineers, what can go wrong, search traffic); where the vendor is ahead; the eight questions; running both; what to do; legal points; About FORA.

The standards map (/resources/standards-map/). Thirteen machine-readable standards and the eight jobs they do, with a layer figure. RSL declares terms and specifies a license server; FORA declares, transacts and reports.

About (/about/). The mission, built in the open for the open internet, the people behind FORA and its supporters, how it's developed, and how to talk about it and join in. "About" is added to the site and docs headers.

Figures. Nineteen hand-drawn figures, each with a text version. A figure opens full size on click, Enter or Space.

Sources. Every page ends with a numbered source list; [N] markers link to it where an inline link doesn't fit.

Components. New: GlanceCard, KeyFacts, Callout, StatusTag, Figure, SectionDivider, SeriesNav, StepList, Split, CompareTable, MarketMap, ForaGlance, MoneyTiles, StandardsMapTable. Extended: Band (band variables, links in leads), CardGrid (links in text), PointList (tone="neutral"), PullQuote (neutral edge, small size), SourceList (numbered, #src-N ids), LinkRow, AudienceHero. Shared texts live in src/data/content-marketplaces.ts.

Existing pages.

  • Resources index: a "Content marketplaces and standards" section.
  • Home: "No one owns your customer" replaces the middleman line.
  • Brand kit: says what the name and the mark mean (fora is the plural of forum).
  • Blue now marks only FORA's own points: pull-quote edges and ticks on others' points are neutral, here and on two published resource pages.
  • check-doc-conformance.sh allows the company's own domain in its old-org check.

Checks. npm run build (102 pages, links valid), npm test (161 pass), npm run routes and routes:check (clean, 101 routes), check-doc-conformance.sh (clean). A separate crawl of the new and changed pages found all 1,345 internal links and anchors valid. Pages checked at 1280 px and 390 px with no horizontal scroll.

src/data/content-marketplaces.ts holds the texts every page of the series
uses word for word: About FORA, the definitions, the search callout, the
eight comparison questions, the GlanceCard rows, FORA's fixed cells, the
status vocabulary and the series list. The three TollBit figures are
palette PNGs, 1024 px square.
New: GlanceCard, KeyFacts, Callout (seven kinds, edge colour by voice,
optional disclosure on narrow screens), StatusTag, Figure (with a text
version), StepList, Split, CompareTable, SectionDivider and SeriesNav.
Status tags and citation markers are global atoms in landing.css, with
their markup in src/lib/resource-markup.ts.

Extended without changing existing pages: Band gains --lp-surface, --lp-bg,
--lp-muted and --lp-fora, a compact option and top-aligned asides; CardGrid
reads the band variables and takes a status; PointList takes inline HTML and
a numbered checklist form; PullQuote has a small size; SourceList can number
its entries with id=src-N; LinkRow can stack; AudienceHero's badge can hold
a link.
A resource can name a section; the index lists entries without one as
before, then one band per section with its heading and intro. The series
lists a page once it is built: TollBit for now.
/resources/content-marketplaces/tollbit/, built from the editorial pattern
components, with numbered sources that the copy's markers link to.
A pull quote's edge is now grey: a quote is always someone else's words.
PointList gains tone="neutral" for points that are a vendor's or nobody's
in particular, set on the 'ahead' lists, the questions, PCM's column, the
Perplexity timeline and the standards map's status and differences.
Below 760px each player's card shows what's sold and who pays today; the
other columns fold behind a per-card More disclosure on the player's line.
The desktop table is unchanged.
Add /about/: the mission, what FORA is, Postindustria and the people
who build FORA, how the protocol is developed, and how to take part.

The header links to it: About joins LANDING_PAGES, so the site nav and
the docs header both list it. With five links the nav fits on one row
just above the menu breakpoint only with tighter gaps, so the nav sets
them between 769 and 960 px and keeps each link on one line.

The positioning statement and the tagline move to
src/data/content-marketplaces.ts, shared by /about/ and the
content-marketplaces page, which renders as before.
RSL's job is Declare terms, with the license server it specifies in its
cell; FORA is the only Transact. The section opens with what exists: the
spec, Supertab's server named in Daily Kos's RSL file, and no named buyer.
Figure standards-1 re-rendered with Transact holding FORA only.
The section listed what exists today, a built-versus-not framing. It now
states what FORA consists of, and the Exchange operator line describes
running an Exchange on FORA Server under the operator's own rules and fees.
Selection Engine, Content Deduplication, Budget Enforcement and Deployment
described a design rather than FORA Server, and were off the sidebar. The
overview now states the order rule (relevance, the agent compares prices),
that offers for the same content are grouped and none dropped, that the
agent's budget is its own constraint, that a Broker's fee is never folded
into the signed price, and what an operator deploys to run FORA Server's
Broker. The four URLs redirect to the overview, and How Money Flows links
there.
The docs no longer explain FORA by OpenRTB, Prebid, SSPs or walled
gardens. The SSP-Alpha and SSP-Beta Exchanges in the examples are
Exchange Alpha and Exchange Beta, and the ssp hostnames are .example
hosts. The quote in the fair-collective evidence follows How Money Flows.
The page framed the operator as an ad-tech aggregator, projected revenue
and named real companies as example operators. It now describes running
an Exchange: anyone can run FORA Server, every FORA agent can buy from
it, and the operator sets its own rules and fee. What an operator deploys,
the calls the Exchange answers, the fee and agent policy, and how
publishers and agents join follow FORA Server. Role types replace the
named operators. The SSP mapping, the revenue model, the dispute tiers,
the NFR targets and the old billing interface are gone.
The page explained FORA by ad-tech fraud history and claimed controls
that neither the protocol nor FORA Server has: single-use URLs, per-tenant
signing keys, automatic dispute credits, quota tracking, and Exchange-side
fetching of License.uri. Each countermeasure now states what the protocol
defines and what FORA Server does, with the real field names. The example
lookalike domain is fictional, the SSRF table states each SDK's default,
and the taxonomy lists every threat once. A Security group in the sidebar
holds the page.
The Exchange table has three columns, and the two admin calls get a row
each.
@EugeneDymo
EugeneDymo merged commit cf797f3 into docs/broker-relevance Nov 16, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants