From 81d6988e7a4f29d6d52132e9ee1bf1c17bb52be3 Mon Sep 17 00:00:00 2001
From: Pierre-Yves Chibon <pingou@pingoured.fr>
Date: Apr 18 2016 09:17:02 +0000
Subject: Document why we block project with a part after the / of exactly 40 chars


---

diff --git a/pagure/lib/__init__.py b/pagure/lib/__init__.py
index 5825c78..eba41bd 100644
--- a/pagure/lib/__init__.py
+++ b/pagure/lib/__init__.py
@@ -974,6 +974,12 @@ def new_project(session, user, name, blacklist, allowed_prefix,
             'of a group that you are part of.'
         )
     if len(second_part) == 40:
+        # We must block project with a name <foo>/<bar> where the length
+        # of <bar> is exactly 40 characters long as this would otherwise
+        # conflict with the old URL schema used for commit that was
+        # <foo>/<commit hash>. To keep backward compatibility, we have an
+        # endpoint redirecting <foo>/<commit hash> to <foo>/c/<commit hash>
+        # available as an option.
         raise pagure.exceptions.PagureException(
             'Your project name cannot have exactly 40 characters after '
             'the `/`'