ObliviOS Developer portal Project site

Home / Decisions / ADR-272

Improve the search-engine face of both sites, count page views on oblivios.dev too, and link the portal from oblivios.org.

Accepted, recorded 19 November 2026.

Decision
ADR-272
Date
2026-11-19
Status
AcceptedAccepted (owner, 2026-11-19: make the SEO perfect for both sites, technical and text; analytics on oblivios.dev too; the Search Console steps in the chat). The cut of a title, the page note, the lastmod rule and the three new wordings are the agent's calls; the owner may overrule each.
Mentions
ADR-261, ADR-268

Shown as written

This entry has 8 columns where the log has seven, because a cell holds the separator of the table or a column is missing. The cells follow in their order, under the label of their place.

1Decision

Improve the search-engine face of both sites, count page views on oblivios.dev too, and link the portal from oblivios.org.

(1) Base.astro fits every title to 60 characters and every description to 160 at a word (a decision title is cut after the suffix that names the portal is dropped), and a page of a list (/decisions/<n>, /boundaries/<n>, /threat-model/abuse-cases/<n>) ends its description with Page <n>., so that no two pages share a description. Both check-build.mjs fail on a title over 60 or a description over 160 characters.

(2) Both sitemaps carry lastmod, read from the log and never typed: the date of the entry for a decision page of the portal, the date of the newest decision for every other page. (3) Three texts of oblivios.org change: the title of FAQ (Frequently asked questions: ObliviOS, it was 13 characters) and the descriptions of Privacy and What it does (they were over 160).

(4) The page-view counter of Vercel Web Analytics (ADR-261) is turned on for oblivios.dev, which replaces the rule of ADR-268 (6) that the portal counts no view: in a build made by Vercel (VERCEL=1) every page carries the tag /_vercel/insights/script.js besides /browse.js, and check-build.mjs of the portal requires exactly those two scripts there and one script in any other build.

(5) portal of site/org/src/lib/site.mjs is no longer null: the header and the footer of oblivios.org link https://oblivios.dev, which ADR-268 held back until the portal is live.

2Why and evidence

A result that is cut in the middle of a word or that shows the same description for twenty pages is the cheapest thing to fix and the first thing a reader of a search page sees. Fitting once in the shared head means no page depends on its author counting, and the check keeps it so. A lastmod that is only the build date is ignored by search engines; a date read from the log is true for each page.

The owner wants to see whether the portal is read as well as the site. Rejected: a noindex on the search page (the owner's rule is that nothing is hidden), hreflang (one language), more structured data types such as FAQPage (the rich result for it is limited to a few sites), a sitemap index (315 addresses fit one file), keywords meta (no engine reads it).

3Further text

[measured: a script over the build, before] of the 315 pages of the portal 279 had a title over 60 characters (up to 202), 250 a description over 160 and 21 shared a description; oblivios.org had one title under 15 and two descriptions over 160.

[measured: after] none of these remain, check-build passes for both sites with VERCEL=1 (11 and 316 pages, 11,274 links on the portal), every sitemap entry has a lastmod, both home pages carry the analytics tag, and the header of oblivios.org shows the portal link.

Not done: the Analytics switch of the Vercel project of the portal (the owner's account), the Search Console properties and sitemaps (the owner's account), the live read of the changed pages (after the push), a Lighthouse or rich-result run, and the 28 pages with a heading level skip (the aria-level pattern of the portal was chosen on purpose for the axe check).

4Further text

The portal counts views, which ADR-268 chose not to do: a second script is a second thing to check, and the check does. A cut title can hide the end of a long decision title; the full title is the heading of the page. Search engines may ignore lastmod.

5Last cell

The owner wants the portal without a counter; a search engine shows a title or description that reads badly; a page of a list gets a description of its own; Vercel changes the path of its script.

Read from docs/governance/decision-log.md, entry ADR-272.