/* The docs route. Its own stylesheet, loaded after web/event-grid.css.
 *
 * WHAT THIS FILE DOES NOT DO: define a palette, a face, a ground or a topbar.
 * Those come from event-grid.css, read-only, exactly as kol.css takes them.
 * Restating them here is the one change that would let this page and the rest
 * of the site drift apart while both looked correct in isolation.
 *
 * One column, no cards, no bubbles, no borders around the blocks. The page is a
 * document: what separates one block from the next is space and a heading, and
 * a box around each would make twelve things out of one.
 */

/* The same 1360 column the panel and the footer use, and the same 16px gutter.
   88px of topbar plus air at the top. */
.docs {
  max-width: 1360px;
  margin: 0 auto;
  padding: 128px 16px 96px;
}

/* ANCHORED SCROLLS LAND CLEAR OF THE BAR. The grid links straight into this
   page -- docs.html#how-to-vote from the how-to-vote bubble -- and every block
   here has an id precisely so it can be linked to. Without this the browser
   scrolls the heading to y=0, which is 88px of fixed topbar. 104px is the value
   the grid already uses on .hero, .controls and its own sections; matching it
   rather than picking a number keeps the two pages landing identically. */
.docs-title,
.docs-block {
  scroll-margin-top: 104px;
}

/* The page's own heading. Lowercase like the rest of the house voice; the
   disclaimer in the footer is the only sentence-case copy on the site. */
.docs-title {
  margin: 0;
  font-size: clamp(32px, 4vw, 52px);
  font-weight: 500;
  line-height: 1.05;
  letter-spacing: -0.02em;
  color: var(--text-primary);
  font-variation-settings: "FLAT" 0;
}

.docs-updated {
  margin: 10px 0 0;
  font-size: 12px;
  letter-spacing: 0.04em;
  color: var(--text-subtle);
}

/* Space between blocks, and a hairline, because twelve headings with nothing
   between them read as one long list rather than as separate answers. The rule
   is the site's own --panel-border, not a new value. */
.docs-block {
  margin-top: 48px;
  padding-top: 32px;
  border-top: 1px solid var(--panel-border);
}

/* The first block sits under the title, where the title is already the
   separation. */
.docs-block:first-of-type { border-top: 0; padding-top: 0; margin-top: 40px; }

.docs-block h2 {
  margin: 0 0 16px;
  font-size: clamp(20px, 2vw, 26px);
  font-weight: 500;
  line-height: 1.15;
  letter-spacing: -0.01em;
  color: var(--text-primary);
  font-variation-settings: "FLAT" 0;
}

/* MEASURED, not chosen by eye: this is the body of a rules page and people
   have to be able to read all of it. --text-primary at the body size, not the
   muted token the footer's legal copy uses -- that one is a notice you consult,
   this is a page you read. */
.docs-block p {
  margin: 0 0 12px;
  max-width: 70ch;
  font-size: 16px;
  line-height: 1.65;
  color: var(--text-primary);
}

.docs-block p:last-child { margin-bottom: 0; }

/* The API-written times. Same size as the body; it is a sentence in the block,
   not a caption beside it. */
.docs-times { color: var(--text-primary); }

.docs-verify-link a,
.docs-block a {
  color: var(--text-primary);
  text-decoration: underline;
  text-underline-offset: 3px;
  text-decoration-color: var(--text-subtle);
  transition: text-decoration-color var(--duration-fast) var(--ease-out);
}

.docs-block a:hover { text-decoration-color: var(--text-primary); }
.docs-block a:focus-visible {
  outline: 2px solid var(--text-muted);
  outline-offset: 3px;
  border-radius: 2px;
}

/* A short list, not prose and not a two-column table. Each line is a label and
   what it means -- and one of the three is a label with nothing to add, which
   is why this is a list and not a grid with an empty cell in it. */
.docs-statuses {
  margin: 0;
  padding: 0;
  list-style: none;
  max-width: 70ch;
}

.docs-statuses li {
  margin: 0 0 10px;
  font-size: 16px;
  line-height: 1.65;
  color: var(--text-primary);
}

.docs-statuses li:last-child { margin-bottom: 0; }

/* The key carries the weight; what follows it is ordinary body text. */
.docs-status-key {
  font-weight: 500;
  font-variation-settings: "FLAT" 0;
}

@media (max-width: 900px) {
  .docs { padding: 112px 16px 72px; }
  .docs-block { margin-top: 36px; padding-top: 24px; }
  .docs-statuses li { margin-bottom: 14px; }
}