85 lines
3.6 KiB
HTML
85 lines
3.6 KiB
HTML
{% 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 %}
|