doc: update the outage documentation, add e-mail template

doc/maintenance/announce_outage.rst

@@ -19,20 +19,34 @@ follow the steps outlined in this document.
 Planned outage
 --------------
 
-1. Prepare the infrastructure ticket similar to `this old one <https://pagure.io/fedora-infrastructure/issue/10854>`_.
+1. Red Hatters-only: Schedule a calendar event, and invite the ``Engineering
+   Outage Calendar`` room.
 
-2. Send email to `copr-devel`_ mailing list informing about an upcomming
-   release.  We usually copy-paste text of the infrastructure ticket created in a
-   previous step. Don't forget to put a link to the ticket at the end of the
-   email.  See the `example <https://lists.fedoraproject.org/archives/list/copr-devel@lists.fedorahosted.org/message/FVVX3Y7IVRTFW3NYVBTWX3AK3BHNRATX/>`_.
+2. Prepare `an infrastructure ticket
+   <https://pagure.io/fedora-infrastructure/new_issue>`_ using one of these
+   templates
 
-3. Adjust the `Matrix channel`_ title so it contains a message similar to::
+   .. toctree::
+       :maxdepth: 1
+
+       Upgrading packages <announce_outage_example_01>
+
+3. Send email to `copr-devel`_ mailing list informing about an upcomming
+   release.  We usually copy-paste text of the infrastructure ticket, including
+   a back-reference to the *infra ticket*.  Sending to::
+
+       copr-devel@lists.fedorahosted.org
+       copr-team@redhat.com
+       OPT-IN buildsys@lists.fedoraproject.org
+       OPT-IN devel@lists.fedoraproject.org
+
+4. Adjust the `Matrix channel`_ title so it contains a message similar to::
 
         Planned outage 2022-08-17 20:00 UTC - https://pagure.io/fedora-infrastructure/issue/10854
 
-4. Create a new "planned" `Fedora Status SOP`_ entry.
+5. Create a new "planned" `Fedora Status SOP`_ entry.
 
-6. Create warning banner on Copr homepage::
+7. Create warning banner on Copr homepage::
 
      copr-frontend warning-banner --outage_time "2022-12-31 13:00-16:00 UTC" --ticket 1234
 

doc/maintenance/announce_outage_example_01.rst

@@ -0,0 +1,49 @@
+.. _outage_announce_01:
+
+Upgrading packages
+------------------
+
+The Fedora Infra ticket and the e-mail may look like::
+
+    Subject: Fedora Copr Outage - Updating to a <Month> <Year> Version
+    ------------------------------------------------------------------
+
+    There will be a Fedora Copr outage starting at
+
+        $ date --date "2023-11-28 13:30 UTC"
+
+    The outage will last approximately 2 hours.  The build queue processing will
+    be stopped during the outage, and the Frontend/Web-UI will be down most of
+    the time (no new tasks accepted).
+
+    <EITHER>
+    The DNF packages and repositories (hosted on copr-backend) will be available
+    during this outage.
+
+    <OR>
+    The DNF packages and repositories (hosted on copr-backend) will be
+    unavailable for a short period, about 10 minutes, as the copr-backend
+    machine will be rebooted.
+
+    Reason for outage:
+    We will update the infrastructure machines to the latest packages that are
+    currently being developed.
+
+    Affected Services:
+    https://copr.fedorainfracloud.org/
+    https://download.copr.fedorainfracloud.org/results/
+
+    Upstream ticket:
+    https://github.com/fedora-copr/copr/issues/<ticket>
+
+    <e-mail backref to infra ticket>
+    Infrastructure ticket:
+    https://pagure.io/fedora-infrastructure/issue/11468
+
+    Please join Fedora Build System Matrix channel:
+    https://matrix.to/#/#buildsys:fedoraproject.org
+
+    Outage Contacts:
+    @nikromen (Jiří Kyjovský) / @frostyx (Jakub Kadlčík) / @praiskup (Pavel Raiskup)
+
+    Or comment on this ticket.