wip: add explanatory comments

Author: radoering

src/poetry/core/constraints/version/version_range_constraint.py

@@ -36,6 +36,15 @@ def allowed_min(self) -> Version | None:
         if self.min is None:
             return None
 
+        # That is a bit inaccurate because
+        # 1) The exclusive ordered comparison >V MUST NOT allow a post-release
+        #    of the given version unless V itself is a post release.
+        # 2) The exclusive ordered comparison >V MUST NOT match
+        #    a local version of the specified version.
+        # https://peps.python.org/pep-0440/#exclusive-ordered-comparison
+        # However, there is no specific min greater than the greatest post release
+        # or greatest local version identifier. These cases have to be handled by
+        # the callers of allowed_min.
         return self.min
 
     @property
@@ -50,6 +59,9 @@ def allowed_max(self) -> Version | None:
             # this is an equality range
             return self.max
 
+        # The exclusive ordered comparison <V MUST NOT allow a pre-release
+        # of the specified version unless the specified version is itself a pre-release.
+        # https://peps.python.org/pep-0440/#exclusive-ordered-comparison
         return self.max.first_devrelease()
 
     def allows_lower(self, other: VersionRangeConstraint) -> bool: