From af97a0320e4c114b2e2a21b32d98a9867c130de4 Mon Sep 17 00:00:00 2001
From: Tim Flink <tflink@fedoraproject.org>
Date: May 09 2023 17:28:31 +0000
Subject: [PATCH 1/2] adding a sysadmin SOP for adding externally hosted services


---

diff --git a/modules/sysadmin_guide/nav.adoc b/modules/sysadmin_guide/nav.adoc
index 83fa465..1684b5e 100644
--- a/modules/sysadmin_guide/nav.adoc
+++ b/modules/sysadmin_guide/nav.adoc
@@ -26,6 +26,7 @@
 ** xref:dnf-counting.adoc[DNF Counting - SOP]
 ** xref:dns.adoc[DNS repository for fedoraproject - SOP]
 ** xref:docs.fedoraproject.org.adoc[Docs - SOP]
+** xref:externally-hosted-services.adoc[Externally Hosted Services - SOP]
 ** xref:fas-notes.adoc[Fedora Account System - SOP]
 ** xref:fas-openid.adoc[FAS-OpenID - SOP]
 ** xref:fedmsg-certs.adoc[fedmsg (Fedora Messaging) Certs, Keys, and CA - SOP]
diff --git a/modules/sysadmin_guide/pages/externally-hosted-services.adoc b/modules/sysadmin_guide/pages/externally-hosted-services.adoc
new file mode 100644
index 0000000..e913f8f
--- /dev/null
+++ b/modules/sysadmin_guide/pages/externally-hosted-services.adoc
@@ -0,0 +1,41 @@
+= Externally Hosted Services
+
+There are services which are requested but not hosted using the traditional Fedora infrastructure. This SOP describes
+the process for getting those services integrated.
+
+
+== Contact Information
+Owner:::
+  Fedora Infrastructure Team
+Contact:::
+  #fedora-admin, sysadmin-main, sysadmin-dns
+Purpose:::
+  Allow externally hosted services to appear as *.fedoraproject.org
+
+== Description
+
+Allowing external services to have a *.fedoraproject.org DNS entry will be decided on a case-by-case basis. Regardless
+of where or how a service is hosted, if it can be accessed via a Fedora project domain, there is an impression that we
+are responsible and that the service represents us.
+
+To submit a service for consideration, open a ticket with the following information:
+
+ * What is the promise of support?
+
+ * Is there a point of contact for issues of normal priority?
+
+    - If there are problems identified, this is the contact point that will deal with them.
+    - Use common sense to decide whether the point of contact should be included in the ticket. If it's not included,
+      be ready to submit it via less public channels.
+
+ * Is there a point of contact for emergency or sensitive issues?
+
+    - This is for issues which either can't wait for the normal support process or require more descretion.
+    - This will frequently be contact information (email, phone number) for a specific person
+    - Do not put contact information for individuals in the ticket
+
+ * Acknowlegement that the service provider has been told who is authorized to ask for changes and a list of who
+   those people are.
+
+Once the ticket has been submitted, there will be a discussion and decision on whether or not a *.fedoraproject.org
+DNS entry will be allocated for this service.

From a7dd90e1c35b528297d4b75de08b1237dbcb3d7a Mon Sep 17 00:00:00 2001
From: Tim Flink <tflink@fedoraproject.org>
Date: May 10 2023 19:03:35 +0000
Subject: [PATCH 2/2] external-services: fix wording around final approval


---

diff --git a/modules/sysadmin_guide/pages/externally-hosted-services.adoc b/modules/sysadmin_guide/pages/externally-hosted-services.adoc
index e913f8f..2ddca09 100644
--- a/modules/sysadmin_guide/pages/externally-hosted-services.adoc
+++ b/modules/sysadmin_guide/pages/externally-hosted-services.adoc
@@ -18,7 +18,7 @@ Allowing external services to have a *.fedoraproject.org DNS entry will be decid
 of where or how a service is hosted, if it can be accessed via a Fedora project domain, there is an impression that we
 are responsible and that the service represents us.
 
-To submit a service for consideration, open a ticket with the following information:
+To submit a service for consideration, open an infrastructure ticket with the following information:
 
  * What is the promise of support?
 
@@ -37,5 +37,5 @@ To submit a service for consideration, open a ticket with the following informat
  * Acknowlegement that the service provider has been told who is authorized to ask for changes and a list of who
    those people are.
 
-Once the ticket has been submitted, there will be a discussion and decision on whether or not a *.fedoraproject.org
-DNS entry will be allocated for this service.
+Once the infrastructure related issues are in order, submit a Fedora council ticket for final approval before a
+*.fedoraproject.org DNS entry will be allocated for the service.

