Document the use of realm in archives.

ci/builders/README.md

@@ -150,7 +150,8 @@ configuration.
   "type": "gcs",
   "include_paths": [
      "out/host_debug/zip_archives/linux-x64/artifacts.zip"
-  ]
+  ],
+  "realm": "production"
 }
 ```
 
@@ -176,6 +177,10 @@ cleanups. Gcs is expected for any artifacts being consumed by the flutter tool.
 given destination.
 * **cas_archive** - a boolean value indicating whether the build output will
 be archived to CAS or not. The default value is true.
+* **realm** - a string value of either `production` or `experimental`
+where production means the artifact will be uploaded to the location expected
+by the flutter tool and experimental will add an `experimental` prefix to the
+path to avoid interfering with production artifacts.
 
 #### Drone\_dimensions
 
@@ -508,19 +513,27 @@ new artifacts combining outputs of multiple sub-builds.
 ### Global Archives
 
 The archives component provides instructions to upload the artifacts generated
-by the global generators. Is a list of dictionaries with two keys: `source` and
-`destination`. `source` is a path relative to the checkout repository and
-`destination` is a relative path to <bucket>/flutter/<commit>.
+by the global generators. Is a list of dictionaries with three keys: `source` and
+`destination`, and `realm`. `source` is a path relative to the checkout repository,
+`destination` is a relative path to <bucket>/flutter/<commit>, and `realm` is
+a string with either `production` or `experimental` value.
+
+The realm value is used to build the destination path of the artifacts.
+`production` will upload the artifacts to the location expected by the flutter
+tool and `experimental` will add experimental as a prefix to the path to avoid
+interfering with the production artifacts.
 
 ```json
 "archives": [
     {
         "source": "out/debug/artifacts.zip",
-        "destination": "ios/artifacts.zip"
+        "destination": "ios/artifacts.zip",
+        "realm": "production"
     },
     {
         "source": "out/debug/ios-objcdoc.zip",
-        "destination": "ios-objcdoc.zip"
+        "destination": "ios-objcdoc.zip",
+        "realm": "experimental"
     }
 ]
 ```