/* Documentation pages — extends the main design system in ../styles.css */

.doc-hero {
  padding: var(--s10) 0 var(--s8);
  border-bottom: 1px solid var(--border);
}

.doc-hero .project-icon { margin-bottom: var(--s3); }

.doc-title {
  font-size: clamp(30px, 5vw, 46px);
  font-weight: 700;
  margin-bottom: var(--s2);
}

.doc-lede {
  font-size: clamp(16px, 2vw, 19px);
  color: var(--text-muted);
  max-width: 60ch;
  margin-bottom: var(--s3);
}

.doc-hero .tag-list { margin-bottom: var(--s4); }

.doc-section { padding: var(--s8) 0; }
.doc-section + .doc-section { border-top: 1px solid var(--border); }

.doc-section h2 {
  font-size: clamp(24px, 3.5vw, 30px);
  margin-bottom: var(--s3);
}

.doc-section h3 {
  font-size: 19px;
  margin: var(--s4) 0 var(--s2);
}

.doc-section p, .doc-section li {
  color: var(--text-muted);
  max-width: 68ch;
}
.doc-section p strong, .doc-section li strong { color: var(--text); }

.doc-section ul {
  padding-left: 20px;
  display: grid;
  gap: var(--s1);
  margin: 0 0 var(--s3);
}

/* Audience label chips */
.audience {
  display: inline-block;
  font-family: var(--font-display);
  font-size: 12px;
  font-weight: 600;
  letter-spacing: 0.12em;
  text-transform: uppercase;
  color: var(--accent-2);
  background: var(--surface);
  border: 1px solid var(--border);
  border-radius: 999px;
  padding: 4px 14px;
  margin-bottom: var(--s2);
}

/* Fact / decision cards */
.fact-grid {
  display: grid;
  grid-template-columns: repeat(2, 1fr);
  gap: var(--s2);
  margin: var(--s3) 0;
}

.fact-card {
  background: var(--surface);
  border: 1px solid var(--border);
  border-radius: var(--radius-sm);
  padding: var(--s3);
}

.fact-card h4 {
  font-size: 15px;
  margin-bottom: var(--s1);
}

.fact-card p {
  font-size: 14px;
  margin: 0;
}

/* Inline code */
code {
  font-family: ui-monospace, "SF Mono", Menlo, monospace;
  font-size: 0.88em;
  background: var(--surface-strong);
  border: 1px solid var(--border);
  border-radius: 6px;
  padding: 1px 6px;
  color: var(--text);
}

/* Footer CTA band */
.doc-cta {
  text-align: center;
  padding: var(--s8) 0 var(--s10);
  border-top: 1px solid var(--border);
}
.doc-cta .hero-actions { justify-content: center; margin-bottom: 0; }

@media (max-width: 720px) {
  .fact-grid { grid-template-columns: 1fr; }
}

/* --- instructions pages --- */
.quickstart {
  background: var(--surface);
  border: 1px solid var(--border);
  border-left: 3px solid var(--yellow, var(--accent-2));
  border-radius: var(--radius-sm);
  padding: var(--s3) var(--s4);
  margin: var(--s4) 0;
}
.quickstart h3 { margin: 0 0 var(--s1); font-size: 16px; }
.quickstart p { margin: 0; font-size: 15px; }

.step-list {
  list-style: none;
  counter-reset: step;
  padding: 0;
  display: grid;
  gap: var(--s3);
  margin: var(--s3) 0 0;
}
.step-list > li {
  counter-increment: step;
  position: relative;
  padding-left: 56px;
  max-width: 68ch;
}
.step-list > li::before {
  content: counter(step, decimal-leading-zero);
  position: absolute;
  left: 0;
  top: 2px;
  font-family: var(--font-display);
  font-weight: 700;
  font-size: 14px;
  color: var(--green, var(--accent-2));
  background: var(--surface);
  border: 1px solid var(--border);
  border-radius: 10px;
  padding: 6px 9px;
}
.step-list h3 { margin: 0 0 6px; font-size: 17px; }
.step-list p { margin: 0; font-size: 15px; }
.step-list p + p { margin-top: 8px; }