Refguid update for mechanism to allow to wait for autogeneration completion

Author: PavelShirvanov

content/en/docs/refguide/modeling/menus/version-control-menu/_index.md

@@ -17,7 +17,7 @@ The **Pull** option updates the local app to the latest revision that was commit
 
 ## Commit
 
-The **Commit** option commits all local changes made to the app since the previous commit to the version control server. For more information, see [Commit](/refguide/commit-dialog/).
+The **Commit** option commits all local changes made to the app since the previous commit to the version control server. For more information, see [Commit](/refguide/commit-dialog/). The commiting process starts with handling asynchronous content generation by waiting for completion, preventing unexpected post-commit file changes (such as *theme.compiled.css.map*) and providing troubleshooting options if errors or timeouts occur, see [Synchronizing commit content](/refguide/sync-commit-content/).
 
 ## Push{#push}
 

content/en/docs/refguide/modeling/menus/version-control-menu/sync-commit-content.md

@@ -0,0 +1,24 @@
+---
+title: "Synchronizing commit content"
+url: /refguide/sync-commit-content/
+weight: 30
+---
+
+
+There are several components in StudioPro where some files on disk need to be generated for the App to function. For example:
+- Theme cache,
+- JavaScript Actions, 
+- Java Actions, 
+- etc. 
+
+These files are generated based on the Documents in the App. In some cases generation of these files takes long time (typically proportional to the app size). This is why we cannot add those generated files to *.gitignore* file – it might slow down App opening and cause errors in some editors. 
+Due to the above we introduced an additional step in **Prepare commit process** that ensures generated content is up to date and generation is complete before Committing the changes to the repository. 
+
+The last step on the dialog below calls synchronization commit content. The current kind of synchronization is displayed in Progress.
+
+{{< figure src="/attachments/refguide/modeling/menus/version-control-menu/sync-commit-content/prepare-commit-process.png" alt="Prepare commit process" >}}
+
+If any synchronization fails during this step the form below is displayed asking if it should continue or cancel commit process explaining the failures and statuses. The form lists only the synchronizers that have failed. 
+
+{{< figure src="/attachments/refguide/modeling/menus/version-control-menu/sync-commit-content/sync-failure-dialog.png" alt="Synchronization failure dialog" >}}
+