docs: add caution about opt_timeout usage and update flow versioning guidelines

- Added a caution note about the current use of opt_timeout for visibility timeout
- Clarified that future updates will use abort signals for job termination
- Updated the table of safe and breaking changes in flow versioning documentation to include
checkmarks for safe modifications and crosses for breaking changes

Author: jumski

pkgs/website/src/content/docs/how-to/update-flow-options.mdx

@@ -20,6 +20,14 @@ You can safely modify these runtime options without creating a new flow version:
 | `opt_base_delay` | Base retry delay (seconds) | 1 | Flow only |
 | `opt_timeout` | Max execution time (seconds) | 60 | Flow & Steps |
 
+<Aside title="About opt_timeout" type="caution">
+Currently, `opt_timeout` is only used to set the visibility timeout of messages in the queue. You should set this value to be higher than the maximum time a job can possibly run. If processing takes longer than the timeout, the message will become visible again and may be processed by another worker, leading to duplicate processing.
+
+In the future, the Edge Worker will use abort signals to terminate jobs past their timeout, but currently, it does not do this.
+
+For more details on visibility timeouts, see the [Edge Worker Configuration](/edge-worker/getting-started/configuration/#visibilitytimeout) documentation.
+</Aside>
+
 ## Configuration System
 
 pgflow uses a two-level configuration approach:

pkgs/website/src/content/docs/how-to/version-your-flows.mdx

@@ -33,10 +33,10 @@ Before making changes to your flows, understand which modifications are safe:
 
 | Safe Changes | Breaking Changes |
 | ------------ | --------------- |
-| Modifying step implementation | Adding/removing steps |
-| Adjusting retry parameters | Changing step dependencies |
-| Updating timeout values | Modifying input/output types |
-| Bug fixes within steps | Changing step slug names |
+| ✅ Modifying step implementation | ❌ Adding/removing steps |
+| ✅ Adjusting retry parameters | ❌ Changing step dependencies |
+| ✅ Updating timeout values | ❌ Modifying input/output types |
+| ✅ Bug fixes within steps | ❌ Changing step slug names |
 
 ## Version Management Strategy