From 07325dcf1135ace4861a20837ea5def42236ad2f Mon Sep 17 00:00:00 2001
From: Klaas van Schelven <klaas@vanschelven.com>
Date: Sat, 9 Dec 2023 08:48:15 +0100
Subject: [PATCH] Note why we don't do per-org releases

---
 releases/models.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/releases/models.py b/releases/models.py
index 09a3520..03f9db0 100644
--- a/releases/models.py
+++ b/releases/models.py
@@ -31,6 +31,9 @@ def ordered_releases(*filter_args, **filter_kwargs):
 class Release(models.Model):
     id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False)
 
+    # sentry does releases per-org; we don't follow that example. our belief is basically: [1] in reality releases are
+    # per software package and a software package is basically a bugsink project and [2] any cross-project-per-org
+    # analysis you might do is more likely to be in the realm of "transactions", something we don't want to support.
     project = models.ForeignKey(
         "projects.Project", blank=False, null=True, on_delete=models.SET_NULL)  # SET_NULL: cleanup 'later'