Respostas:
As tags de comentário estão documentadas em https://docs.djangoproject.com/en/stable/ref/templates/builtins/#std:templatetag-comment
{% comment %} this is a comment {% endcomment %}
Os comentários de linha única estão documentados em https://docs.djangoproject.com/en/stable/topics/templates/#comments
{# this won't be rendered #}
Em contraste com os comentários html tradicionais como este:
<!-- not so secret secrets -->
Comentários do modelo do Django são renderizados no html final. Assim, você pode ficar à vontade para colocar detalhes da implementação, como:
Multi-linha:
{% comment %}
The other half of the flexbox is defined
in a different file `sidebar.html`
as <div id="sidebar-main">.
{% endcomment %}
Única linha:
{# jquery latest #}
{#
beware, this won't be commented out...
actually renders as regular body text on the page
#}
Acho isso especialmente útil para <a href="{% url 'view_name' %}"
visualizações que ainda não foram criadas.
Os comentários de várias linhas nos modelos de django usam da seguinte maneira ex: para .html etc.
{% comment %} All inside this tags are treated as comment {% endcomment %}
{% extends "file.html" %}
tag, coloque-a na parte superior do arquivo de modelo, mesmo antes do{% comment %}
...{% endcomment %}
, caso contrário, você receberá um<ExtendsNode: extends "file.html"> must be the first tag in the template
erro. Estou dizendo que, caso alguém queira colocar os comentários de várias linhas na parte superior do modelo.