The docmd 0.6.2 release focuses on refining the navigation architecture for complex, versioned documentation sites while providing deep insights through enhanced analytics and improving site-wide user experience with automated breadcrumbs.

✨ Highlights

Smart Version Switcher

Say goodbye to 404s when switching versions. The version switcher now intelligently checks if the current page exists in the target version. If an exact match isn’t found, it gracefully falls back to the root of that version instead of showing a “Not Found” page.

Navigation Architecture V2 (navigation.json)

Manage large, versioned documentation sites with ease. You can now place a navigation.json file directly inside your versioned documentation folders (e.g., docs-05/navigation.json). This eliminates the need for massive, duplicated navigation arrays in your main docmd.config.js.

Automated Breadcrumbs

Every documentation page now features automated breadcrumbs located right above the title. This improves user orientation within deeply nested hierarchies and provides better context for both human readers and AI models. Breadcrumbs are enabled by default and can be toggled via config.layout.breadcrumbs.

Analytics V2 (Auto-Event Tagging)

The Analytics plugin has been significantly upgraded to support auto-event tagging. It now automatically tracks:

• External Link Clicks: Understand where your users go after reading your docs.
• Downloads: Automatically track clicks on PDFs, ZIPs, and other binary assets.
• Search Keywords: Track what users are looking for with debounced keyword logging (can be disabled via trackSearch: false).
• Navigation Interactions: Track Table of Contents (TOC) clicks and permalink (heading anchor) usage.

📝 Complete Changelog

🛠️ Core Generator

• V2 Nav Resolution: Added support for the navigation.json resolution pattern.
• Breadcrumb Logic: Implemented automated crumb trail calculation based on navigation active-state.
• Stable Version Switching: updated docmd-main.js with fetch(HEAD) validation for version links.

🛡️ Security & Stability

• Dependency Fix: Patched a high-priority vulnerability in the flatted library related to unbounded recursion DoS in the parse() revive phase.
• PWA Safety: Added an explicit Service Worker unregistration safety net to prevent ghost caches for users who remove the PWA plugin.

🔌 Plugins

• Analytics V2: New autoEvents option (enabled by default) for event tracking without manual code injection.