Add composite index testing guidance to ReadMe

.github/workflows/ci_tests.yml

@@ -135,7 +135,7 @@ jobs:
         if: github.event_name == 'pull_request' && contains(matrix.module, ':firebase-firestore')
         run: |
           cd firebase-firestore
-          terraform apply -var-file=../google-services.json -auto-approve
+          terraform apply -var-file=../google-services.json -auto-approve &> /dev/null
         continue-on-error: true
       - name: ${{ matrix.module }} Integ Tests
         env:

firebase-firestore/README.md

@@ -87,6 +87,30 @@ Run:
 ./gradlew :firebase-firestore:deviceCheck
 ```
 
+### Testing composite index query against production
+#### Setting Up the Environment:
+1. Navigate to the `firebase-android-sdk/firebase-firestore` directory.
+2. Create a `google-services.json` file. This file should contain your target Firebase project's
+configuration.
+2. If not already logged in, authenticate with your Google Cloud Platform (GCP) account using
+`gcloud auth application-default login`. You can check your logged-in accounts by running
+`gcloud auth list`.
+3. Create composite indexes by running:
+```
+terraform init
+terraform apply -var-file=../google-services.json -auto-approve
+```
+Note: If the index creation encounters issues, such as concurrent operations, consider running the
+index creation process again. Error messages indicating that indexes have already been created can
+be safely disregarded.
+
+#### Adding new composite index query tests
+1. To create a new composite index for local development, click on the provided link in the test
+error message, which will direct you to the Firebase Console.
+2. Add the newly created composite index to the `firestore_index_config.tf` file. The "__name__"
+field is not required to be explicitly added to the file, as the index creation will auto complete
+it on behalf.
+
 ## Code Formatting
 
 Run below to format Java code:

firebase-firestore/src/androidTest/java/com/google/firebase/firestore/CompositeIndexQueryTest.java

@@ -30,14 +30,13 @@
  * Guidance for Creating Tests:
  * ----------------------------
  * When creating tests that require composite indexes, it is recommended to utilize the
- * "CompositeIndexTestHelper" class. This utility class provides methods for creating
- * and setting test documents and running queries with ease, ensuring proper data
- * isolation and query construction.
+ * "CompositeIndexTestHelper" class. This utility class provides methods for creating and setting
+ * test documents and running queries with ease, ensuring proper data isolation and query
+ * construction.
  *
- * Please remember to update the main index configuration file (firestore_index_config.tf)
- * with any new composite indexes needed for the tests. This ensures synchronization with
- * other testing environments, including CI. You can generate the required index link by
- * clicking on the Firebase console link in the error message while running tests locally.
+ * To get started, please refer to the instructions provided in the README file. This will guide
+ * you through setting up your local testing environment and updating the Terraform configuration
+ * with any new composite indexes required for your testing scenarios.
  */
 @RunWith(AndroidJUnit4.class)
 public class CompositeIndexQueryTest {