Restructured and added context

Author: ToriLindsay

src/content/docs/stream/reference/index.mdx

@@ -2,12 +2,12 @@
 pcx_content_type: concept
 title: Transform videos
 sidebar:
-  order: 5
+  order: 4
   badge:
     text: Beta
 ---
 
-Media Transformations let you optimize and manipulate videos stored _outside_ of the Cloudflare Stream. Transformed videos and images are served from one of your zones on Cloudflare.
+You can optimize and manipulate videos stored _outside_ of Cloudflare Stream with Media Transformations. Transformed videos and images are served from one of your zones on Cloudflare.
 
 To transform a video or image, you must [enable transformations](/stream/transform-videos/#getting-started) for your zone. If your zone already has Image Transformations enabled, you can also optimize videos with Media Transformations.
 
@@ -136,6 +136,9 @@ Media Transformations are currently in beta. During this period:
 
 - Transformations are available for all enabled zones free-of-charge.
 - Outputs from Media Transformations will be cached, but if they must be regenerated, the origin fetch is not cached and may result in subsequent requests to the origin asset.
+- Maximum input file size is 100 MB. Maximum duration of input video is 10 minutes.
+- Media Transformations are not compatible with [Bring Your Own IP (BYOIP)](/byoip/).
+- Input video should be an MP4 with H.264 encoded video and AAC or MP3 encoded audio. Other formats may work but are untested.
 
 ## Pricing
 

src/content/docs/stream/transform-videos/index.mdx

@@ -2,7 +2,7 @@
 pcx_content_type: how-to
 title: Define source origin
 sidebar:
-  order: 4
+  order: 2
   badge:
     text: Beta
 ---
@@ -12,7 +12,7 @@ When optimizing remote videos, you can specify which origins can be used as the
 On this page, you will learn how to define and manage the origins for the source videos that you want to optimize.
 
 :::note
-The allowed origins setting applies to requests from Cloudflare Workers. 
+The allowed origins setting applies to requests from Cloudflare Workers.
 
 If you use a Worker to optimize remote videos via a `fetch()` subrequest, then this setting may conflict with existing logic that handles source videos.
 :::

src/content/docs/stream/transform-videos/sources.mdx

@@ -2,28 +2,22 @@
 pcx_content_type: troubleshooting
 title: Troubleshooting
 sidebar:
-  order: 8
+  order: 3
+  badge:
+    text: Beta
 ---
 
-## Error responses from Media Transformations
-
-When resizing fails, the response body contains an error message explaining the reason, as well as the `Cf-Resized` header containing `err=code`:
+If you are using Media Transformations to transform your video and you experience a failure, the response body contains an error message explaining the reason, as well as the `Cf-Resized` header containing `err=code`:
 
 - 9401 — The required options are missing or are invalid. Refer to [Options](/stream/transform-videos/#options) for supported arguments.
-- 9402 — The video was too large or the origin server did not respond as expected. Refer to [Source video requirements](/stream/transform-videos/#source-video-requirements) for more information.
+- 9402 — The video was too large or the origin server did not respond as expected. Refer to [source video requirements](/stream/transform-videos/#source-video-requirements) for more information.
 - 9404 — The video does not exist on the origin server or the URL used to transform the video is wrong. Verify the video exists and check the URL.
 - 9406 & 9419 — The video URL is a non-HTTPS URL or the URL has spaces or unescaped Unicode. Check your URL and try again.
 - 9407 — A lookup error occurred with the origin server's domain name. Check your DNS settings and try again.
 - 9408 — The origin server returned an HTTP 4xx status code and may be denying access to the video. Confirm your video settings and try again.
 - 9412 — The origin server returned a non-video, for example, an HTML page. This usually happens when an invalid URL is specified or server-side software has printed an error or presented a login page.
 - 9504 — The origin server could not be contacted because the origin server may be down or overloaded. Try again later.
 - 9509 — The origin server returned an HTTP 5xx status code. This is most likely a problem with the origin server-side software, not the transformation.
-- 9517 & 9523 — Internal errors. Please contact support if you encounter these errors.
-
----
-
-## Limits
+- 9517 & 9523 — Internal errors. Contact support if you encounter these errors.
 
-- Maximum input file size is 100 MB. Maximum duration of input video is 10 minutes.
-- Media Transformations is not compatible with [Bring Your Own IP (BYOIP)](/byoip/).
-- Input video should be an MP4 with H.264 encoded video and AAC or MP3 encoded audio. Other formats may work but are untested.
+---