Reorganize docs and update reader search flows

scripts/run_ui_regression.sh

@@ -4,7 +4,7 @@ set -u
 set -o pipefail
 
 ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-PROJECT_PATH="${PROJECT_PATH:-$ROOT_DIR/ReadViewDemo/ReadViewDemo.xcodeproj}"
+PROJECT_PATH="${PROJECT_PATH:-$ROOT_DIR/ReadViewDemo/ReadViewDemo.xcworkspace}"
 SCHEME_NAME="${SCHEME_NAME:-ReadViewDemo}"
 CONFIGURATION="${CONFIGURATION:-Debug}"
 SIMULATOR_NAME="${SIMULATOR_NAME:-iPhone 16 Plus}"
@@ -111,10 +111,16 @@ echo "  destination:  $DESTINATION"
 echo "  test type:    $TEST_TYPE"
 echo "  results:      $RUN_DIR"
 
+if [[ "$PROJECT_PATH" == *.xcworkspace ]]; then
+  PROJECT_FLAG="-workspace"
+else
+  PROJECT_FLAG="-project"
+fi
+
 XCODEBUILD_ARGS=(
   xcodebuild
   test
-  -project "$PROJECT_PATH"
+  "$PROJECT_FLAG" "$PROJECT_PATH"
   -scheme "$SCHEME_NAME"
   -configuration "$CONFIGURATION"
   -destination "$DESTINATION"