Mintlify's transition from mint.json to docs.json marks a significant update aimed at simplifying navigation management for users by consolidating tabs, anchors, versions, and groups into a single recursive structure. This new schema removes the complexity associated with mapping separate fields, offering greater flexibility in organizing documentation hierarchies and allowing for arbitrary mixing and nesting of various division types without constraints tied to folder structures. The original mint.json setup, effective in earlier stages, became cumbersome as new features were added, complicating navigation management. By redefining the navigation solely through the navigation field in docs.json, the refactored codebase provides a more intuitive and streamlined way for customers to define navigation, enabling tabs and anchors to exist independently of their folder names and supporting a diverse range of hierarchical configurations. This update enhances user freedom in structuring documentation, supporting complex combinations of divisions across languages, versions, anchors, and dropdowns, and encourages users to upgrade their CLI to fully utilize the new capabilities.