docs: recommend the sync workflow for changes to C8 REST API vNext (#5113)

Author: pepopowitz

howtos/interactive-api-explorers.md

@@ -20,14 +20,22 @@ The source for each API's instance lives in an identifying folder within the `/a
 
 ## Updating an OpenAPI spec
 
-### Regenerate the docs for the Next version of an API
+### Automatic synchronization (applies only to the Next version of the C8 REST API)
+
+[A workflow](https://github.com/camunda/camunda-docs/actions/workflows/sync-rest-api-docs.yaml) is configured to synchronize the "next" version of the REST API docs, scheduled on a weekly basis. The workflow pulls the specification from [the upstream camunda/camunda repo's `main` branch](https://github.com/camunda/camunda/blob/main/zeebe/gateway-protocol/src/main/proto/rest-api.yaml), and re-generates the documentation for the "next" version based on that spec.
+
+If you've made changes to the upstream `main` branch but do not require urgent documentation updates, you should wait for that scheduled workflow to incorporate your changes.
+
+If you've made changes to the upstream `main` branch and require urgent documentation updates, you should trigger [that workflow](https://github.com/camunda/camunda-docs/actions/workflows/sync-rest-api-docs.yaml) manually.
+
+### Regenerate the docs for the Next version of any API
 
 1. Replace the OpenAPI spec file at `/api/[apiName]/[apiName]-openapi.yaml`.
 2. Regenerate the docs with this command:
    `npm run api:generate:[apiName]`
 3. Commit the changes, and open a PR.
 
-### Regenerate the docs for a numbered version of an API
+### Regenerate the docs for a numbered version of any API
 
 1. Replace the OpenAPI spec file at `/api/[apiName]/[version]/[apiName]-openapi.yaml`.
 2. Regenerate the docs with this command: