{#
# Description:
# Web Template used in Farol Design
#
# Authors:
# Benoît Allard <benoit.allard@greenbone.net>
#
# Copyright:
# Copyright (C) 2014 Greenbone Networks GmbH
#
# This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License
# as published by the Free Software Foundation; either version 2
# of the License, or (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
-#}

{% extends "base.j2" %}
{% from "macros.j2" import textinput, textarea, examples %}
{% block title %}Edit Revision{% endblock %}

{% block content %}
<p><strong>Revision</strong> contains all the elements required to track the evolution of a CVRF document. Each change to a CVRF document should be accompanied by <strong>Number</strong>, <strong>Date</strong>, and <strong>Description</strong> elements.</p>
<form role="form" method="POST">
  {% call textinput("number", "Number", "a.b.c.d", number, required=True, regex='(0|[1-9][0-9]*)(\.(0|[1-9][0-9]*)){0,3}') %}
  <p><strong>Number</strong> should contain the numeric version of the document. Like the <strong>Version</strong> element above, it is a numeric tokenized field of the format “nn” with up to four fields “nn.nn.nn.nn”. It is recommended that this be a monotonically increasing value. Minor revisions should be used for less-significant changes (for example, <samp>1.0.0.0</samp> to <samp>1.0.0.1</samp>). Major, actionable changes should lead to a major increase of the version number (for example, <samp>1.0</samp> to <samp>2.0</samp>).</p>
  <p>Examples of such changes include:</p>
  <ul>
    <li>Any change to severity or impact</li>
    <li>The announcement of additional vulnerabilities</li>
    <li>The announcement of additional vulnerable products</li>
    <li>A significant change in remediation status</li>
  </ul>
  <p>The most recent <strong>Number</strong> element should <em>always</em> match the <strong>Version</strong> element. It is validated using the following regular expression: <code>(0|[1-9][0-9]*)(\.(0|[1-9][0-9]*)){0,3}</code>.</p>
  {% endcall %}
  {% call textinput("date", "Date", "", date and date.isoformat() or '', required=True, type="datetime") %}
  <p><strong>Date</strong> should record the date the revision was made. All dateTime values in CVRF require a time, and we recommend the inclusion of a time zone as well (ICASI endorses the use of Greenwich mean time [GMT] or “Zulu time”). If a time zone is excluded, Zulu should be assumed.</p>
  {% endcall %}
  {% call textarea("description", "Description", "", description, 3, required=True) %}
  <p><strong>Description</strong> should be a short description of the changes made. It can describe the conditions that prompted the change or be a short list of the items changed.</p>
  {{ examples(['initial public release']) }}
  {% endcall %}
  {% if action == 'Add' %}
    <div class="form-group">
      <div class="checkbox">
        <label>
          <input name="update_tracking" type="checkbox" checked> Update Tracking Information
        </label>
      </div>
    </div>
  {% endif %}
  <button class="btn btn-primary" type="submit">{{ action or 'Update' }}</button>
  <a class="btn btn-danger" href="{{ url_for('.view') }}">Cancel</a>
</form>
{% endblock %}