{% extends "base.html" %} {% from "layout/icons.html" import icon %} {% block title %}{{ _("Documentation") }}{% endblock %} {% block content %} {# A list of `listed` items and its folded rest; with a filter, each item carries its kind and the rest's summary is written once per kind, so the chips can show the right count without the script translating anything. #} {% macro listing(items, filter=none) -%}
{{ text }}
{{ _("How well the repository explains itself: its guide's rationale, its commits, its decisions and its documents. Measured from the code and the guide, without calling your assistant.") }}
{{ _("Codetrail couldn't read the target's data; the log says why.") }}
{% else %}{{ _("Update the guide once: reading the code is free, and the metrics come from it.") }}
{% endif %}{{ _("No pages yet: the guide's rationale is measured once your assistant writes it.") }}
{% else %} {{ stack([("heat-4", rationale.by_source.adr, _("ADRs")), ("heat-3", rationale.by_source.docs, _("Documents")), ("heat-2", rationale.by_source.code, _("Code comments")), ("heat-1", rationale.by_source.commit, _("Commit messages")), ("tone-inferred", rationale.inferred, _("Inferred"))]) }}{{ _("The commit history couldn't be read just now; the log says why.") }}
{% else %} {{ about(_("The latest commits on the branch, merges left out. A commit explains why when its body matches the target's commit_why_pattern.")) }} {{ stack([("tone-documented", commits.explains_why, _("Explain why")), ("tone-other", commits.body_only, _("Body without a why")), ("tone-quiet", commits.subject_only, _("Subject only"))]) }} {% if commits.withheld %}{% trans count=commits.withheld %}{{ count }} message withheld: gitleaks flagged it{% pluralize %}{{ count }} messages withheld: gitleaks flagged them{% endtrans %}
{% endif %} {% if commits.without_why %}{{ commit.sha[:7] }}{{ commit.subject }}{% if commit.body %}{{ _("body without a why") }}{% else %}{{ _("subject only") }}{% endif %}{% endcall %}
{{ _("No architecture decision records were found where the target's settings say they live.") }}
{% else %} {{ about(_("A proposed ADR needs attention once it waits longer than the target's settings allow, and a superseded or deprecated one while a guide page still cites it. Worth a look: proposed ADRs with no date, and accepted ones no page cites.")) }}{{ _("External packages, projects and infrastructure resources that some document names. A mention isn't a reason: this only shows what no document talks about at all.") }}
{% if not has_pages %}{{ _("Which facts the guide explains, and which ADRs it cites, are measured once your assistant has written its pages.") }}
{% endif %}