[workers-observability] add examples for source maps in changelog and documentation

Author: rohinlohe

src/assets/images/workers-observability/with-source-map.png

@@ -0,0 +1,33 @@
+---
+title: Source Maps are Generally Available
+description: Source maps are now Generally Available with a larger maximum size limit
+products:
+  - workers
+date: 2025-03-25T12:00:00Z
+---
+
+Source maps are now Generally Available (GA). You can now be uploaded with a maximum gzipped size of 15 MB.
+Previously, the maximum size limit was 15 MB uncompressed.
+
+Source maps help map between the original source code and the transformed/minified code that gets deployed 
+to production. By uploading your source map, you allow Cloudflare to map the stack trace from exceptions
+ onto the original source code making it easier to debug. 
+
+![Stack Trace without Source Map remapping](src/assets/images/workers-observability/without-source-map.png)
+**No Source Map uploaded**: notice how all the Javascript has been minified to one file, so the stack trace is missing information on file name, shows incorrect line numbers, and incorrectly references `js` instead of `ts`.
+
+![Stack Trace with Source Map remapping](src/assets/images/workers-observability/with-source-map.png)
+**With Source Map uploaded**: all methods reference the correct files and line numbers.
+
+Uploading source maps and stack trace remapping happens out of band from the Worker execution,
+so source maps do not affect upload speed, bundle size, or cold starts. The remapped stack
+traces are accessible through Tail Workers, Workers Logs, and Workers Logpush.
+
+To enable source maps, add the following to your
+[Pages Function's](pages/functions/source-maps/) or [Worker's](/workers/observability/source-maps/) wrangler configuration:
+
+<WranglerConfig>
+```toml
+upload_source_maps = true
+```
+</WranglerConfig>

src/assets/images/workers-observability/without-source-map.png

@@ -35,10 +35,8 @@ When `upload_source_maps` is set to `true`, Wrangler will automatically generate
 
 :::note
 
-
 Miniflare can also [output source maps](https://miniflare.dev/developing/source-maps) for use in local development or [testing](/workers/testing/integration-testing/#miniflares-api).
 
-
 :::
 
 ## Stack traces
@@ -64,6 +62,25 @@ When Cloudflare attempts to remap a stack trace to the Worker's source map, it d
 | ------------------------------ | ------------- |
 | Maximum Source Map Size        | 15 MB gzipped |
 
+## Example
+
+Consider a simple project. `src/index.ts` serves as the entrypoint of the application and `src/calculator.ts` defines a ComplexCalculator class that supports basic arithmetic.
+
+<FileTree>
+- wrangler.jsonc
+- tsconfig.json
+- src
+	- calculator.ts
+	- index.ts
+</FileTree>
+
+Let's see how source maps can simplify debugging an error in the ComplexCalculator class.
+
+![Stack Trace without Source Map remapping](~/assets/images/workers-observability/without-source-map.png)
+**No Source Map uploaded**: notice how all the Javascript has been minified to one file, so the stack trace is missing information on file name, shows incorrect line numbers, and incorrectly references `js` instead of `ts`.
+
+![Stack Trace with Source Map remapping](~/assets/images/workers-observability/with-source-map.png)
+**With Source Map uploaded**: all methods reference the correct files and line numbers.
 
 ## Related resources
 

src/content/changelog/workers/2025-02-25-gzip-source-maps.mdx

@@ -9,5 +9,5 @@ Workers Logs is included in both the Free and Paid [Workers plans](/workers/plat
 
 |                    | Log Events Written                                                 | Retention  |
 | ------------------ | ------------------------------------------------------------------ | ---------- |
-| **Workers Free**   | 200,000 per day                                                    | 7 Days     |
+| **Workers Free**   | 200,000 per day                                                    | 3 Days     |
 | **Workers Paid**   | 20 million included per month <br /> +$0.60 per additional million | 7 Days     |