Sync open source content 🐝 (from 09b676dba2323e3b9d845814174db02d8e534700)

Author: beezythebot

docs/speakeasy-reference/cli/merge.md

@@ -1,15 +1,13 @@
-# merge
+# merge  
 `speakeasy merge`  
 
-Merge multiple OpenAPI documents into a single document.
 
-## Details
-
-Merging multiple OpenAPI documents together allows for multiple teams or departments to control their own API endpoints, and merge the end result later. Or one document for API endpoints, and another document for webhooks, with the end goal being getting it into one OpenAPI document to make it more portable. 
+Merge multiple OpenAPI documents into a single document  
 
-This is a bit different to "bundling" or "dereferencing", which is about pulling external references into the main document. 
+## Details
 
-**Note:** Any duplicate operations, components, etc. will be overwritten by the next document in the list.
+Merge multiple OpenAPI documents into a single document, useful for merging multiple OpenAPI documents into a single document for generating a client SDK.
+Note: That any duplicate operations, components, etc. will be overwritten by the next document in the list.
 
 ## Usage