{% extends 'workflows/base_shell.html' %}
{% load static i18n %}

{% block title %}{% trans "Handbook" %}{% endblock %}



{% block extra_css %}
<link rel="stylesheet" href="{% static 'workflows/css/docs_pages.css' %}" />
{% endblock %}

{% block shell_body %}
      {% include 'workflows/includes/app_header.html' with header_show_home=1 header_inside_shell=1 %}
    <div class="page-stack">
    <div class="top">
      <h1>{% trans "Handbook" %}</h1>
    </div>
    <p class="sub">{% trans "Operational and engineering documentation in one place." %}</p>

    <div class="grid">
      <section class="card">
        <div class="eyebrow">{% trans "Operations" %}</div>
        <h2>{% trans "Project Wiki" %}</h2>
        <p>{% trans "Operational and product-level documentation for onboarding, offboarding, PDFs, integrations, admin tools, and system behavior." %}</p>
        <ul>
          <li>{% trans "workflow overview" %}</li>
          <li>{% trans "admin tools and system behavior" %}</li>
          <li>{% trans "integrations and operations" %}</li>
          <li>{% trans "operations and troubleshooting" %}</li>
        </ul>
        <div class="actions">
          <a class="btn btn-secondary" href="/admin-tools/wiki/">{% trans "Open Project Wiki" %}</a>
        </div>
      </section>

      <section class="card">
        <div class="eyebrow">{% trans "Engineering" %}</div>
        <h2>{% trans "Developer Handbook" %}</h2>
        <p>{% trans "Engineering guide for architecture, branch workflow, deployment, CI/CD, code guidelines, and maintenance." %}</p>
        <ul>
          <li>{% trans "repository and service structure" %}</li>
          <li>{% trans "branch workflow and coding guidelines" %}</li>
          <li>{% trans "Docker and migration workflow" %}</li>
          <li>{% trans "translation and builder architecture" %}</li>
          <li>{% trans "CI/CD, deployment, security, and maintenance notes" %}</li>
        </ul>
        <div class="actions">
          <a class="btn btn-secondary" href="/admin-tools/developer-handbook/">{% trans "Open Developer Handbook" %}</a>
        </div>
      </section>

      <section class="card">
        <div class="eyebrow">{% trans "Deployment" %}</div>
        <h2>{% trans "Host & Domain Setup" %}</h2>
        <p>{% trans "Runbook for ALLOWED_HOSTS, CSRF trusted origins, canonical domain variables, and how to resolve Invalid HTTP_HOST errors safely." %}</p>
        <ul>
          <li>{% trans "APP_DOMAIN and APP_BASE_URL" %}</li>
          <li>{% trans "ALLOWED_HOSTS and CSRF origin rules" %}</li>
          <li>{% trans "local test versus production examples" %}</li>
          <li>{% trans "error recovery steps for wrong hostname setup" %}</li>
        </ul>
        <div class="actions">
          <a class="btn btn-secondary" href="/admin-tools/deployment-hosts/">{% trans "Open Host Setup Guide" %}</a>
        </div>
      </section>

      <section class="card">
        <div class="eyebrow">{% trans "Release" %}</div>
        <h2>{% trans "Release Checklist" %}</h2>
        <p>{% trans "Step-by-step release guide for rebuilds, migrations, translations, static assets, smoke checks, and rollout verification." %}</p>
        <ul>
          <li>{% trans "pre-release validation commands" %}</li>
          <li>{% trans "translation, static, and migration steps" %}</li>
          <li>{% trans "post-release smoke checks" %}</li>
          <li>{% trans "rollback and evidence checklist" %}</li>
        </ul>
        <div class="actions">
          <a class="btn btn-secondary" href="/admin-tools/release-checklist/">{% trans "Open Release Checklist" %}</a>
        </div>
      </section>
    </div>
    </div>
  
{% endblock %}