Sync open source content 🐝 (from 0534065be2ec37be9b4b981d38469b86bc372be4)

Author: beezythebot

docs/sdks/publish-sdk.mdx

@@ -315,3 +315,32 @@ For GitHub actions set up with `mode:pr`, the publishing dashboard highlights op
   }}
 />
 
+## Customizing GitHub release notes
+
+When publishing SDKs, Speakeasy automatically generates release notes for GitHub releases based on generator changes. To customize these release notes or add release notes when no generator changes are detected, edit the `releaseNotes` property in the `gen.lock` file.
+
+The `releaseNotes` property is used for generating GitHub release notes.
+
+### Editing release notes
+
+To customize release notes, add or edit the `releaseNotes` field in your `.speakeasy/gen.lock` file:
+
+```yaml
+# .speakeasy/gen.lock
+lockVersion: 2.0.0
+id: abc123
+management:
+  # ... other fields
+features:
+  # ... feature flags
+releaseNotes: |
+  ## What's new
+  - Added support for new authentication methods
+  - Improved error handling for rate limits
+  - Fixed pagination issues in list endpoints
+```
+
+<Callout title="Tip">
+It's safe to edit the `releaseNotes` property before merging an auto-generated PR. The SDK generation workflow validates for changes before running, so your edits won't be overwritten during regeneration.
+</Callout>
+