Delba de Oliveira

This commit introduces **two new agent skills**, `write-guide` and `write-api-reference`, to enhance the **documentation generation process**. These **new capabilities** provide structured templates and workflows for agents to create consistent **technical guides** with progressive disclosure and standardized **API reference documentation**. The `write-guide` skill ensures a consistent format (intro, summary, steps, next steps), while `write-api-reference` adapts to API types for uniform references. This work significantly improves the efficiency and formatting consistency of the project's documentation by enabling agents to generate high-quality first drafts.

This commit **restructures the documentation** for **App Router route segment configuration options** by splitting individual config options into their own dedicated files. Specifically, documentation for `dynamicParams`, `maxDuration`, `preferredRegion`, and `runtime` is now located in separate `.mdx` files within `docs/01-app/03-api-reference/03-file-conventions/02-route-segment-config/`. An `index.mdx` file was also added to serve as a central hub, listing and linking to these new individual config pages. This **documentation refactoring** involved updating numerous internal links across various guide and API reference documents to reflect the new file paths, significantly improving the organization and discoverability of these critical configuration details.

This commit **improves the documentation** for **public static pages** by performing several **maintenance** updates within `docs/01-app/02-guides/public-static-pages.mdx`. It updates the navigation title, corrects filename attributes in code examples for accuracy, and reformats paragraphs to reduce line breaks. This **documentation improvement** enhances the overall readability and clarity of the guide, making it easier for users to follow and understand the content.

This commit **introduces a new documentation guide** (`docs/01-app/02-guides/public-static-pages.mdx`) detailing how to construct public, mostly static pages using **Cache Components** and **Partial Prerendering (PPR)**. This **new feature documentation** provides developers with best practices for optimizing page performance and data handling. Concurrently, it **refactors the existing glossary** (`docs/01-app/04-glossary.mdx`) by renaming the file and updating definitions for dynamic/static rendering and APIs to align with the new guide's terminology and improve overall clarity. This work is part of a planned series of guides to enhance understanding of advanced page building techniques.

This commit **introduces a new glossary** specifically for **Next.js documentation**, adding a dedicated `glossary.mdx` file within the `docs/01-app` directory. This **documentation enhancement** defines common Next.js terms and concepts, serving as a central reference point for other guides. The primary goal is to improve the clarity and conciseness of the documentation by allowing guides to reference concepts without redundant explanations. This **new documentation feature** will streamline the writing and reading experience across the Next.js guides.

This commit **enhances the Next.js documentation** by integrating comprehensive instructions for the new **Turbopack bundle analyzer** into the `Optimizing Package Bundling` guide. It provides users with updated strategies and steps to analyze and reduce their application's bundle size, including new optimization techniques and code examples. The changes also involve updating internal links across various guides, such as `linking-and-navigating` and `production-checklist`, to correctly reference the new analyzer sections. Additionally, an 'experimental' version tag is added to the `optimizePackageImports` API reference documentation for both App and Pages Routers. This **documentation update** ensures users have the latest information and tools for **bundle optimization** within Next.js.

This commit primarily focuses on **documentation updates** to improve clarity for developers. It **updates the ESLint configuration documentation** by adding a version history table that explicitly details the **deprecation of `next lint` in `v16.0.0`**. Additionally, the commit enhances the **error message documentation** for invalid `next.config.js` files, providing clearer guidance on deprecated or updated configuration options and including a helpful TypeScript example. This **maintenance work** ensures users are well-informed about API changes and can troubleshoot configuration issues more effectively.

This commit **enhances the documentation** for the **`cacheTag` API function** by adding a crucial note about its usage limitations. It clarifies the **maximum length for custom tags** and the **maximum number of tag items** that can be specified when using `cacheTag`. This **documentation update** provides developers with essential information to correctly implement caching strategies, helping them avoid potential issues or unexpected behavior caused by exceeding these tag limits. The change is specifically applied to the `cacheTag.mdx` file within the **API reference documentation**.

This commit **updates the Next.js CLI documentation** to introduce the new `--debug-build-paths` option for the `next build` command. It specifically enhances the **API reference for the `next` CLI** by providing detailed usage instructions and examples for this new debugging flag. This **documentation update** ensures developers are aware of and can effectively leverage `--debug-build-paths` to gain deeper insights into their build process, aiding in the diagnosis of build-related issues.

This commit **enhances the documentation** for **App Router file conventions** by introducing a new section dedicated to `global-not-found.js`. It provides a comprehensive explanation of the purpose and usage of this new convention, clearly outlining its distinctions from the existing `not-found.js` file. This **documentation update** improves developer understanding of how to implement global 404 pages and manage application-wide error handling more effectively.

This commit introduces a **Proof of Concept (POC)** for a **new documentation application** within `apps/docs`, establishing the foundational infrastructure for a future documentation site. It sets up a complete Next.js application leveraging `fumadocs-ui` and `fumadocs-mdx` for dynamic MDX content rendering, including features like static parameter generation, metadata generation, and custom MDX components. This comprehensive **new capability** involves significant **infrastructure setup**, adding dedicated `package.json`, `next.config.ts`, ESLint, Prettier, PostCSS, and TypeScript configurations specific to the `apps/docs` module. The new application integrates global styles with Tailwind CSS and defines core layout components, laying the groundwork for a modern, maintainable documentation platform.

This commit provides **documentation updates** for **Next.js 15.4**, ensuring users are informed about recent feature additions. It specifically updates the **`Link` component** documentation to include the new `prefetch="auto"` option, enhancing clarity on prefetching behavior. Additionally, it documents the new `--debug-prerender` option for the **`next build` CLI command**, providing guidance on its usage for debugging prerendering issues. This **maintenance work** improves the overall **developer experience** by keeping the official documentation current with the latest framework capabilities.

This commit performs a significant **documentation restructuring** for the **App Router**, primarily focusing on improving its **Information Architecture (IA)**. It **deletes a dedicated routing section**, instead **combining Route Handlers and Middleware documentation** for a more cohesive presentation. A **new guide for Backend for Frontend (BFF) patterns** is introduced, alongside extensive **polishing of existing "Getting Started" guides** and numerous **renames and internal link updates** across various guides, API references, and error documentation. This comprehensive update aims to enhance the clarity, consistency, and navigability of the App Router documentation.

This commit performs a significant **refactoring and polishing** of the **Next.js documentation**, specifically within the **`Getting Started` section**. It **reorders pages** to create a more logical flow, grouping related topics such as routing, rendering, data fetching, and UI concerns like styling and images. Furthermore, it **updates page titles and metadata** across numerous `mdx` files, transitioning from "How to" phrasing to keyword-focused titles to improve search engine optimization and clarity. This **documentation maintenance** effort aims to enhance the initial learning experience and overall accessibility for new users.

This commit delivers a comprehensive **documentation update** to the **Getting Started guide** and related sections, directly addressing multiple user feedback issues. It **improves clarity and completeness** by updating installation and upgrade instructions to support `pnpm`, `yarn`, and `bun` package managers, alongside refining `npm` commands. Key changes include reordering code examples for **Server and Client Components**, explicitly mentioning `useEffect` when invoking **Server Functions**, and simplifying descriptions for the **Image component** and **CSS handling**. This **maintenance** work significantly enhances the onboarding experience for new users and ensures the documentation remains accurate and comprehensive across various development setups.

This commit **updates and clarifies the documentation** for **Intercepting Routes** and **Parallel Routes** within the Next.js App Router. It specifically refines the explanation of the `(..)` convention for intercepting routes, detailing its relation to route segments versus the file system and its interaction with parallel routes. The changes include an updated example for intercepting the `/login` route within a parallel route and refined notes on conventions, ultimately enhancing developer understanding of these advanced routing patterns.

This commit **adds a new comprehensive guide** to the **Next.js documentation** explaining how prefetching works and its common implementation patterns. The new `prefetching.mdx` guide covers crucial aspects such as preventing unwanted side-effects during prefetching, strategies for preventing too many prefetches, and how to disable prefetching on hover. It also details advanced patterns like implementing soft navigation with `onClick` and `router.push` for ejected links. This **documentation enhancement** aims to improve developer understanding and best practices for optimizing application performance and user experience by correctly leveraging Next.js prefetching mechanisms.

This commit performs a significant **documentation reorganization** for **middleware**, consolidating its examples and detailed information into a dedicated API reference at `docs/01-app/05-api-reference/03-file-conventions/middleware.mdx`. This **improves the information architecture** by providing a single, comprehensive source for middleware API details. Consequently, numerous internal links across various **App Router and Pages Router documentation guides, API references, and error messages** have been updated to point to this new, authoritative location, enhancing consistency and user experience. This **maintenance work** ensures that users can easily find comprehensive and up-to-date information regarding middleware implementation.

This commit significantly **enhances the documentation for Route Handlers** by consolidating practical examples into the `route.mdx` API reference. This **documentation update** and **information architecture improvement** centralizes explanations for functionalities such as cookies, headers, data revalidation, redirects, dynamic segments, query parameters, streaming, request body handling, CORS, and webhooks. Consequently, related guide pages, like those for RSS feeds and CORS configuration, are updated to link to these new, comprehensive examples. This change improves the discoverability and clarity of **Route Handler** usage for developers.

This commit introduces a **new Data Security Guide** to the **Next.js documentation**, providing comprehensive information on data fetching approaches, reading, mutating data, and auditing practices. Concurrently, the existing `updating-data.mdx` guide receives a **major update**, incorporating new sections on Server Functions, passing actions as props, cookies, and `useEffect` usage. This work also involves **significant documentation refactoring**, including the deletion of an old Data Fetching index page and widespread updates to internal links across numerous guides and API references to align with the new content and improved organization, particularly for **Server Actions** and data handling. This enhances the clarity, accuracy, and navigability of the **documentation** for developers working with data in Next.js applications.