ToriLindsay

This commit **enhances the Stream product's troubleshooting documentation** by addressing a common user issue where a stream connects but fails to start. It introduces a **new troubleshooting section** within `src/content/docs/stream/stream-live/troubleshooting.mdx` to guide users through diagnosing this specific problem. Additionally, the commit refines the existing heading and description for encoder connection issues, providing clearer guidance. This **documentation update** aims to improve the user experience by offering more comprehensive and precise solutions for **Stream Live** operational challenges.

This commit delivers a significant **documentation update** for the **Stream Live** feature, specifically enhancing the `troubleshooting.mdx` guide. It introduces new sections and rephrases existing advice to provide more comprehensive and clearer guidance for users encountering issues with streams not starting, connecting, or disconnecting. This **maintenance** effort aims to improve the user experience by empowering users to more effectively diagnose and resolve common problems within the **Stream Live** ecosystem.

This commit **reverts** a prior change that introduced a **crawl endpoint** within the **Browser Rendering** module. The rollback effectively removes the recently added functionality, ensuring that the system no longer exposes or utilizes this specific endpoint. This **maintenance** action undoes a feature addition, likely due to unforeseen issues or a change in requirements, impacting the **Browser Rendering** subsystem by removing a new capability.

This commit introduces comprehensive **documentation** for the new **`/crawl` REST API endpoint** within the **Browser Rendering** service. It details usage, parameters, and troubleshooting for this new capability, which is being released in beta. Additionally, this **documentation** work updates the **Browser Rendering changelog** to announce the new endpoint, adds specific **Free plan limits** for `/crawl` to the `limits.mdx` file, and enhances the `/json` endpoint documentation with a new troubleshooting section. This provides users with essential information to effectively utilize the new crawling functionality and understand its implications.

This commit provides a **documentation update** for the **Data Localization Suite**, specifically clarifying the behavior of **Dashboard Analytics** when the **Customer Metadata Boundary (CMB)** is utilized in regions outside the United States. It updates footnote 49 in the `src/content/docs/data-localization/compatibility.mdx` file to ensure users have accurate information regarding data handling and analytics functionality in these specific scenarios. This **maintenance** task enhances user understanding and prevents potential misinterpretations of the system's capabilities for international deployments.

This commit **refines the Stream documentation** by **migrating technical specifications** from a general FAQ into more relevant, dedicated pages. It enhances the `get-started` and `index` pages with descriptions of automatic encoding and delivery, while the `uploading-videos` section now includes detailed information on supported frame rates and re-encoding behavior. Additionally, the `using-the-stream-player` documentation gains a new section outlining browser compatibility for both desktop and mobile devices. This **documentation improvement** centralizes crucial technical details, making it easier for users to understand **Stream's capabilities and requirements** for video formats, encoding, and player compatibility.

This commit **enhances the documentation** for the **Stream** product's **Direct Creator Uploads (DCU)** feature. It introduces a **Mermaid sequence diagram** within `src/content/docs/stream/uploading-videos/direct-creator-uploads.mdx` to visually illustrate the entire direct creator upload flow. Additionally, the commit **improves the clarity** of the two distinct steps involved in the underlying **tus protocol**, making the technical process easier to understand for developers and users. This **documentation update** aims to provide a more comprehensive and accessible explanation of the video upload mechanism.

This commit significantly **enhances the Browser Rendering documentation** by introducing a dedicated **'features' section** and a comprehensive **new guide for implementing custom fonts**. The new `custom-fonts.mdx` page provides detailed instructions and examples for integrating custom fonts using both **Workers Bindings** and the **REST API**. This **documentation refactoring** also updates the existing `supported-fonts.mdx` page to remove stale content and correctly link to the new, more detailed custom font instructions, improving overall clarity and user experience for developers.

This commit **improves the documentation** for **Browser Rendering limits** by updating the `limits.mdx` file. It clarifies rate limit explanations with a new footnote, **restructures the FAQ and troubleshooting sections** for better readability, and corrects code block formatting. This **documentation maintenance** effort enhances user understanding of browser rendering limitations and related issues. The changes specifically target the `src/content/docs/browser-rendering/limits.mdx` file, making the information more accessible and accurate.

This commit **updates the documentation** for **Stream's direct creator uploads** feature, enhancing user guidance and clarity. As a **documentation update**, it specifically addresses several key areas within the `direct-creator-uploads.mdx` file. The changes include adding a crucial note regarding billing considerations, clarifying the expected upload status responses, and refining the instructions for tracking upload progress. This ensures users have more comprehensive and accurate information, improving their experience when utilizing direct creator uploads.

This commit provides **documentation enhancements** for **Cloudflare Stream's video uploading methods**, specifically clarifying the relationship between direct creator uploads and the tus protocol. It **distinguishes between basic POST uploads and resumable uploads**, adding a decision flowchart and cross-references to guide users. The update also **enhances upload guidelines** with crucial information about storage reservation and video processing, improving user understanding of the different upload mechanisms and their implications.

[Images] Clarify orientation behavior (#28442)

This commit significantly **enhances the documentation** for **serving private images** with signed URLs, specifically within `src/content/docs/images/manage-images/serve-images/serve-private-images.mdx`. It provides crucial **backend clarification** for implementing signed URL generation, including a **bug fix** for an incorrect `event.request.url` usage in a code example, now correctly `request.url`. The update also promotes **improved security practices** by guiding users to manage signing keys via `wrangler secret put` instead of hardcoding, and adds **TypeScript types** for better code clarity. This **documentation update** ensures users have accurate, secure, and type-safe examples for integrating signed image URLs, preventing common implementation errors.

This commit **updates documentation** to **clarify pricing details** for **Image transformations**, specifically how usage of the **Images binding** is billed. It modifies `src/content/docs/images/pricing.mdx` to explicitly state that every call to the Images binding counts as a transformation for pricing. Concurrently, `src/content/docs/images/transform-images/bindings.mdx` receives a new billing note, reiterating that each call is a unique transformation and linking to the comprehensive pricing page. This **documentation update** provides users with a clearer understanding of the billing implications for their **Images binding** usage, preventing potential confusion.

This commit significantly **enhances the Cloudflare Stream documentation** by introducing a comprehensive guide for **local testing of Stream webhooks**. A new page, `src/content/docs/stream/examples/test-webhooks-locally.mdx`, details how to set up a local testing environment using Cloudflare Workers and Tunnel, while `src/content/docs/stream/manage-video-library/using-webhooks.mdx` is updated to reference this new resource. This **documentation enhancement** restructures the testing process for clarity, incorporates security best practices like using `.dev.vars` for secrets and fixing timing side-channels in signature verification, and provides robust instructions for developers. The **maintenance** work improves the developer experience for integrating with **Cloudflare Stream webhooks**, ensuring more secure and efficient local development workflows.

This **documentation update** significantly improves the clarity and accuracy of the **Browser Rendering limits** information. It specifically targets the `src/content/docs/browser-rendering/limits.mdx` file to clarify pricing details, refine notes pertinent to free and paid plans, and adjust the associated limits table. This **maintenance** work ensures users have a precise understanding of service constraints and pricing tiers for the **Browser Rendering** feature.

This commit provides a **clarification** regarding **pricing rounding** within the **browser rendering** subsystem. The primary goal is to ensure that pricing information is consistently and accurately displayed to users, improving the overall user experience. This **maintenance** update enhances the clarity and precision of how prices are presented in the browser, impacting the visual representation of financial data.

This commit **updates the Images documentation** to **clarify and correct the billing methodology** for unique image transformations. The `src/content/docs/images/index.mdx` file now accurately reflects that the billing period for these transformations is a 'calendar month' instead of '30 days'. Furthermore, `src/content/docs/images/pricing.mdx` provides detailed clarification, emphasizing that billing is per calendar month and repeat requests within the same month are counted only once. This **documentation fix** ensures users have precise and consistent information regarding **Images service pricing**.

This commit introduces an **auto format option** for image output within **Workers Bindings** image transformations. This **new capability** enhances the image processing pipeline by allowing the system to automatically determine the optimal output format. The change is primarily reflected in **documentation updates** to `src/content/docs/images/transform-images/bindings.mdx`, which now clarifies output format requirements and includes an example demonstrating the use of this new dynamic format selection. This provides developers with greater flexibility and efficiency when handling image outputs.

This commit performs a **documentation improvement** by **reordering the sidebar navigation** for the **Browser Rendering REST API documentation**. The changes primarily affect the display order of various endpoint pages, such as `index.mdx`, `json-endpoint.mdx`, and `pdf-endpoint.mdx`, to present them by popularity. Additionally, minor **formatting fixes** were applied to `markdown-endpoint.mdx` and `snapshot.mdx` to enhance readability. This update improves the overall **discoverability and user experience** of the `browser-rendering` REST API documentation.