/* ==========================================================================
   DOCS PAGES — shared how-to layout (Skyland first; TrekPorters/Abacus later)
   ========================================================================== */

.docs-page {
  overflow: auto;
}

.docs {
  position: relative;
  z-index: 2;
  max-width: 44rem;
  margin: 0 auto;
  padding: 5rem clamp(1.25rem, 4vw, 2.5rem) 3rem;
  background-image:
    linear-gradient(to right, var(--grid-line) 1px, transparent 1px),
    linear-gradient(to bottom, var(--grid-line) 1px, transparent 1px);
  background-size: 24px 24px;
  min-height: 100vh;
}

.docs-back {
  margin: 0 0 1.5rem;
}

.docs-header {
  margin-bottom: 2.25rem;
}

.docs-title {
  font-family: "Minecrafter", Impact, sans-serif;
  text-transform: uppercase;
  font-size: clamp(2.5rem, 8vw, 4rem);
  color: var(--ink-dim);
  letter-spacing: 0.04em;
  text-shadow: 2px 2px 0 #000, 3px 3px 0 #000;
  margin: 0.35rem 0 0.75rem;
}

.docs-lede {
  margin: 0;
  font-size: 1.1rem;
  line-height: 1.45;
  color: var(--ink-soft);
  max-width: 36rem;
}

.docs-section {
  margin: 0 0 2.25rem;
  padding-top: 0.25rem;
  border-top: 1px solid var(--grid-line-hot);
}

.docs-section h2 {
  margin: 1.25rem 0 0.85rem;
  font-size: clamp(1.35rem, 3vw, 1.75rem);
}

.docs-steps,
.docs-list {
  margin: 0;
  padding-left: 1.25rem;
  color: var(--ink-soft);
  line-height: 1.5;
}

.docs-steps li,
.docs-list li {
  margin: 0.45rem 0;
}

.docs-note {
  margin: 0 0 1rem;
  font-family: Calibri, "Segoe UI", sans-serif;
  font-size: 0.95rem;
  color: var(--ink-dim);
}

.docs-commands {
  margin: 0;
}

.docs-commands > div {
  margin: 0 0 1.1rem;
  padding-bottom: 1rem;
  border-bottom: 1px solid var(--grid-line);
}

.docs-commands dt {
  margin: 0 0 0.35rem;
  font-family: Consolas, "Courier New", monospace;
  color: var(--accent);
}

.docs-commands dd {
  margin: 0;
  color: var(--ink-soft);
  line-height: 1.45;
}

.docs code {
  font-family: Consolas, "Courier New", monospace;
  font-size: 0.92em;
  color: var(--accent);
}

.docs-figure {
  margin: 1rem 0 1.25rem;
  max-width: 22rem;
}

.docs-figure-pair {
  display: grid;
  grid-template-columns: 1fr;
  gap: 1rem 1.25rem;
  margin: 1rem 0 1.35rem;
  max-width: none;
}

@media (min-width: 640px) {
  .docs-figure-pair {
    grid-template-columns: 1fr 1fr;
    align-items: start;
  }
}

.docs-figure-pair .docs-figure {
  margin: 0;
  max-width: none;
}

.docs-figure img {
  display: block;
  width: 100%;
  height: auto;
  image-rendering: pixelated;
  border: 1px solid var(--grid-line-hot);
  background: #2b2b2b;
}

.docs-figure figcaption {
  margin: 0.5rem 0 0;
  font-family: Calibri, "Segoe UI", sans-serif;
  font-size: 0.92rem;
  line-height: 1.4;
  color: var(--ink-dim);
}

.docs-callout {
  margin: 1rem 0 0;
  padding: 0.75rem 0.9rem;
  border-left: 3px solid var(--accent);
  color: var(--ink-soft);
  line-height: 1.45;
  background: rgba(0, 0, 0, 0.22);
}

.docs-footer {
  margin-top: 2rem;
  border-top: 1px solid var(--grid-line-hot);
}