Workers Docs: A Full Rework of Content and Navigation
Cloudflare has rolled out a significant update to its Workers documentation, addressing long-standing usability complaints and restructuring how content is organized and presented. The revamped site is built on an upgraded docs engine that introduces new UI components and page designs, with the stated goal of making the platform more approachable for both beginners and experienced developers.
The documentation now follows the Divio documentation system, a widely used framework that separates content into four distinct categories: Tutorials, How-to guides, Technical reference, and Learning. Each category is designed to serve a single purpose clearly, which makes it easier to locate the right kind of material for a given task. Tutorials provide step-by-step project walkthroughs, while How-to guides are divided into two sub-sections: Examples, which are code snippets demonstrating specific functions, and Starters, which are fully completed, cloneable projects. The Technical reference is split into three areas—Platform, Runtime APIs, and Wrangler documentation—to help developers find the exact API or tooling details they need. The Learning section offers conceptual overviews of Workers features and topics.
Clearer Page Structure and Formatting
The content itself has also been restructured for readability. Reference pages for classes such as Request now open with a background section that outlines use cases and context, rather than launching directly into the technical details. A table of contents has been added to the right sidebar so that navigating a page with multiple sections is more straightforward. Long-form paragraphs for class variables and parameters have been replaced by list-based breakdowns with ample whitespace, and command-line tool documentation has likewise moved from dense tables to the same easier-to-scan format.
New Design Touches and Features
Several page templates have been redesigned to take advantage of the new engine. The Examples page now supports tags for sorting by category, and the overall layout was cleaned up to make each snippet easier to follow. The Tutorials listing has also been updated to display each tutorial’s difficulty level and expected length, and the set of tutorials has been expanded with new material such as a guide to managing multiple Workers projects with Lerna.
Search, powered by Algolia, has been restyled with clearer text and improved prioritization of results. Dark mode has also been introduced, letting users switch between the light and dark themes depending on their preference. Cloudflare has said the new documentation platform will be used as the basis for revamping docs for its other products in the future. Feedback can be submitted via the workers-docs-engine repository on GitHub.
