[fidldoc] Updating fidl reference docs
diff --git a/all/fidl/fuchsia.feedback/README.md b/all/fidl/fuchsia.feedback/README.md
index f6f743d..19db220 100644
--- a/all/fidl/fuchsia.feedback/README.md
+++ b/all/fidl/fuchsia.feedback/README.md
@@ -120,6 +120,9 @@
<p>Upsert() may be called multiple times for the same <code>component_url</code>, e.g., once for each
launch of the component, in which case only the most recent call's product information
will be used in crash reports.</p>
+<p>UpsertWithAck should be preferred if the client manually files crash reports because a
+fire-and-forget is racy and client cannot know if their crash reports will successfully be
+attributed to the product they specify.</p>
#### Request
<table>
@@ -138,6 +141,34 @@
+### UpsertWithAck {#fuchsia.feedback/CrashReportingProductRegister.UpsertWithAck}
+
+<p>Upsert and notify the client when the operation is complete.</p>
+<p>This allows clients to prevent races between filing crash reports and calls to Upsert.
+Otherwise if a crash report is filed before the upsert completes, the crash report will be
+attriburted to the wrong product, leading to potentially incorrect crash data.</p>
+
+#### Request
+<table>
+ <tr><th>Name</th><th>Type</th></tr>
+ <tr>
+ <td><code>component_url</code></td>
+ <td>
+ <code><a class='link' href='../fuchsia.sys/'>fuchsia.sys</a>/<a class='link' href='../fuchsia.sys/#component_url'>component_url</a></code>
+ </td>
+ </tr><tr>
+ <td><code>product</code></td>
+ <td>
+ <code><a class='link' href='#CrashReportingProduct'>CrashReportingProduct</a></code>
+ </td>
+ </tr></table>
+
+
+#### Response
+<table>
+ <tr><th>Name</th><th>Type</th></tr>
+ </table>
+
## DataProvider {#DataProvider}
*Defined in [fuchsia.feedback/data_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.feedback/data_provider.fidl#14)*
@@ -625,7 +656,7 @@
### CrashReportingProduct {#CrashReportingProduct}
-*Defined in [fuchsia.feedback/crash_register.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.feedback/crash_register.fidl#26)*
+*Defined in [fuchsia.feedback/crash_register.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.feedback/crash_register.fidl#38)*
<p>Product release information to report to the crash server.</p>
