main.docs-shell {
  max-width: 1180px;
  margin: 2.2rem auto 3.2rem;
  padding: 0 1rem;
  display: grid;
  grid-template-columns: 280px 1fr;
  gap: 1.2rem;
}

.docs-hero {
  grid-column: 1 / -1;
  background: var(--card-bg);
  border: 1px solid var(--border-color);
  border-radius: 20px;
  padding: 1.8rem;
  box-shadow: 0 16px 40px rgba(0, 0, 0, 0.2);
}

.docs-kicker {
  margin: 0 0 0.45rem;
  color: var(--accent);
  font-size: 0.78rem;
  letter-spacing: 0.12em;
  font-weight: 700;
}

.docs-hero h1 {
  margin: 0;
  font-size: clamp(1.7rem, 2.8vw, 2.4rem);
  letter-spacing: -0.02em;
  background: linear-gradient(135deg, var(--accent), var(--accent-2) 65%, var(--accent-3));
  -webkit-background-clip: text;
  background-clip: text;
  color: transparent;
}

.docs-hero p {
  margin: 0.7rem 0 0;
  color: var(--text-secondary);
  line-height: 1.65;
  max-width: 78ch;
}

.docs-toc {
  position: sticky;
  top: 92px;
  align-self: start;
  background: var(--card-bg);
  border: 1px solid var(--border-color);
  border-radius: 16px;
  padding: 1rem;
}

.docs-toc h2 {
  margin: 0 0 0.75rem;
  font-size: 0.95rem;
  color: var(--text-primary);
}

.docs-toc a {
  display: block;
  color: var(--text-secondary);
  text-decoration: none;
  font-size: 0.92rem;
  line-height: 1.45;
  padding: 0.42rem 0.5rem;
  border-radius: 8px;
  transition: background-color 0.2s ease, color 0.2s ease;
}

.docs-toc a:hover {
  background: var(--btn-secondary-bg);
  color: var(--accent);
}

.docs-content {
  display: grid;
  gap: 1rem;
}

.doc-card {
  background: var(--card-bg);
  border: 1px solid var(--border-color);
  border-radius: 16px;
  padding: 1.2rem 1.25rem;
}

.doc-card h3 {
  margin: 0 0 0.7rem;
  font-size: 1.1rem;
}

.doc-card p,
.doc-card li {
  color: var(--text-secondary);
  line-height: 1.65;
}

.doc-card ol {
  margin: 0.4rem 0 0;
  padding-left: 1.2rem;
}

.doc-card strong {
  color: var(--text-primary);
}

@media (max-width: 980px) {
  main.docs-shell {
    grid-template-columns: 1fr;
  }

  .docs-toc {
    position: static;
  }
}

@media (max-width: 620px) {
  main.docs-shell {
    margin-top: 1rem;
  }

  .docs-hero,
  .doc-card,
  .docs-toc {
    border-radius: 14px;
  }
}