Document Changes

.github/workflows/tests.yml

@@ -23,7 +23,19 @@ jobs:
       - name: Checkout project sources
         uses: actions/checkout@v3
 
-      - name: Cleanup Homebrew - Nasty Hacksies
+        # This step and the Install Colima step have been modified to address a
+        # Python error started 3.11.2024, emitting the following error:
+        # Error: The `brew link` step did not complete successfully
+        # The formula built, but is not symlinked into /usr/local
+        # Could not symlink bin/2to3
+        #
+        # Others reported: https://github.com/Cockatrice/Cockatrice/issues/5007
+        #
+        # Once the fix enters the Homebrew pipeline, it is safe to remove this.
+        #
+        # Note: Upgrading to a macos-14 runner fixes this, but Colima still
+        # can't install on macos-14 due to virtualization issues.
+      - name: Homebrew Workaround - Temporary
         #run: brew update && brew upgrade && brew cleanup
         run: |
          brew update