docs: add comments about issue #305

Signed-off-by: Pierre-Yves Lapersonne <[email protected]>

.github/workflows/build-and-test.yml

@@ -33,7 +33,7 @@ on:
       - synchronize
 
 jobs:
-  # Build the app (if there are linter errors or compiler issues, it will fail)
+  # Build the app (if there are linter errors or compiler issues, it will fail and we expect this behavior)
   build:
     runs-on: macos-15
     steps:
@@ -58,7 +58,7 @@ jobs:
           cd Showcase
           bundle exec fastlane buildDebugApp
 
-  # Test the library with unit tests
+  # Test the library with unit tests they all must pass whatever the CI/CD environment is)
   unit-test:
     runs-on: macos-15
     steps:
@@ -85,6 +85,8 @@ jobs:
           bundle exec fastlane ios test
 
   # Test the library with UI tests
+  # Do not define the success of these tests for PR merge as a condition
+  # See troubles explained at https://github.com/Orange-OpenSource/ouds-ios/issues/305
   ui-test:
     runs-on: macos-15
     steps: