The Moxie Docs blog

Notes on documentation, codebases, and keeping context current.

Practical writing on keeping documentation in sync with the code, onboarding engineers faster, and giving AI agents context they can trust.

Featured Post
3 min read

Stop Maintaining .cursorrules: A Better Way to Give AI Context

Static .cursorrules files grow bloated, fall out of sync, and go stale. Learn how Model Context Protocol (MCP) servers replace static custom rules files with live, queryable repository context.

ai-agentsmcpdeveloper-velocity
Read post
8 min read

How to Write the Perfect CLAUDE.md File for Claude Code

Claude Code relies on a CLAUDE.md file for instructions on build, test, and style conventions. Learn how to write, structure, and maintain a perfect CLAUDE.md that keeps your AI agent on track.

  • claude-code
  • ai-agents
  • developer-tools
  • +1
5 min read

Living Documentation Best Practices for Agile Teams

Discover best practices for living documentation in Agile teams. Enhance collaboration, transparency, and efficiency with effective documentation strategies tailored for software engineering, DevOps, and startups.

12 min read

Answer Engine Optimization for Developer Docs: How to Get Cited by AI Assistants

Developers now ask AI assistants before they read your docs. Learn how answer engine optimization (AEO) works for documentation: llms.txt, answer-first writing, stable URLs, and why accuracy is the real ranking factor.

  • documentation
  • ai-agents
  • industry-trends
5 min read

Documentation Drift Review: Detection Methods for Technical Teams

Explore effective detection methods for documentation drift to ensure accuracy in technical teams. A comprehensive review for software engineers, writers, and DevOps.

9 min read

Mermaid Diagrams for Developers: Examples, Syntax, and a Free Live Editor

Learn Mermaid diagram syntax with live flowchart, sequence, ER, class, and state examples. Paste into a free browser Mermaid live editor for instant preview, shareable links, and SVG/PNG export.

  • mermaid
  • documentation
  • developer-tools
  • +1
5 min read

GitHub Documentation Gets Real-Time Collaboration Feature Update

Discover the latest GitHub documentation update featuring real-time collaboration tools, enhancing teamwork for software developers, DevOps, and technical writers.

3 min read

Managing AI Agent Context Without the Bloat

Static rule files like .cursorrules get stale fast. We look at how to serve fresh codebase context to AI agents via Model Context Protocol without eating your token limits.

  • mcp
  • ai-agents
  • developer-experience
10 min read

Documentation Drift Spurs New Push to Tie Docs to Code

Discover how documentation drift is prompting a new push to connect documentation directly to code, empowering software engineers and DevOps teams to improve accuracy and consistency.

  • documentation
  • developer-experience
9 min read

Comparing AI Coding Conventions in Auto Documentation and AI Documentation

Explore a comprehensive comparison of AI coding standards in auto documentation and AI documentation workflows, helping engineering leaders and developers optimize their practices.

  • documentation
  • industry-trends
5 min read

Why Documentation Drift Happens and How to Prevent It

Learn why documentation drift occurs and discover practical strategies for preventing it. Essential guide for software teams, technical writers, and DevOps.

  • documentation
  • engineering-management
11 min read

Auto Documentation vs Living Documentation: Which Is More Effective?

Discover the differences between Auto Documentation and Living Documentation to determine which method best enhances your development workflow and maintenance.

  • documentation
  • industry-trends
5 min read

MoxieDocs Review: AI-Powered Documentation for Modern Dev Teams

Discover how MoxieDocs leverages AI-powered technology to streamline documentation for modern software teams, boosting efficiency for developers and technical writers.

  • documentation
  • developer-experience
10 min read

AI Code Conventions: How MoxieDocs Compares to DocuWriter.ai

Compare MoxieDocs and DocuWriter.ai to evaluate AI code standards for documentation. Ideal for engineering leaders and developer-tool buyers seeking top AI documentation platforms.

  • industry-trends
  • documentation
5 min read

GitHub Documentation Gets AI Upgrade with New Copilot Features in 2026

Discover how GitHub documentation is enhanced with new AI-powered Copilot features in 2026, revolutionizing support for software engineering teams and DevOps experts.

  • ai-agents
  • developer-experience
  • documentation
10 min read

AI Code Conventions in 2026: Emerging Trends and Industry Insights

Discover the latest AI code standards and emerging trends in 2026 shaping the industry. Insights for engineering teams, developers, and tech decision-makers.

  • industry-trends
  • ai-agents
11 min read

A Comprehensive Guide to GitHub Documentation for Development Teams

Learn how to effectively utilize GitHub documentation with this guide designed for development teams and engineering managers seeking clear, practical guidance.

  • documentation
  • developer-experience
5 min read

MoxieDocs vs DeepDocs: Which AI Documentation Tool Wins?

Compare MoxieDocs and DeepDocs to find the best AI documentation tool for software teams, technical writers, and AI developers. Discover features and insights to make an informed choice.

  • industry-trends
  • documentation
10 min read

Living Documentation and AI Documentation: A Comparative Overview

Explore a detailed comparison of Living Documentation and AI Documentation, helping software teams and engineers choose the best practices for effective AI-assisted development.

  • documentation
  • industry-trends
10 min read

GitHub Code Coverage on Pull Requests Now in Public Preview

GitHub Code Coverage on pull requests is now available in public preview. Enhance code quality and review confidence with seamless CI integration.

  • developer-experience
  • industry-trends
10 min read

GitHub Documentation Improvements Drive Better Developer Support

Discover how GitHub documentation improvements enhance developer support, streamline workflows, and empower open-source projects. Learn more about these updates

  • developer-experience
  • documentation
10 min read

Ultimate Guide to Auto Documentation for Development Teams

Discover the ultimate guide to auto documentation for development teams, covering best practices, tools, and strategies for reliable documentation workflows.

  • documentation
  • developer-experience
12 min read

8 Top AI Documentation Tools for Engineering Teams in 2026

Discover the top 8 AI documentation tools for engineering teams in 2026. Compare features, pricing, and ease of use for managers evaluating platforms.

  • industry-trends
  • documentation
5 min read

Stop Copy-Pasting: How MCP is Re-Engineering the AI Coding Loop

How the Model Context Protocol (MCP) replaces copy-paste context with a universal API for AI coding — architecture, secure transports, and accurate docs.

  • mcp
  • developer-experience
8 min read

AI code assistants and living documentation in 2026

How AI code assistants now use living documentation: automated updates tied to GitHub activity and context that stays accurate as code changes.

  • documentation
  • ai-agents
12 min read

How to sync documentation with GitHub and keep it alive as your codebase evolves

Sync documentation with GitHub using webhooks, CI/CD, and drift detection so docs stay accurate as your codebase evolves—and your AI tools stay grounded.

  • documentation
  • developer-experience
6 min read

Ship cleaner PRs with agentic AI: use MCP context and living docs

Improve code quality with agentic AI (Claude Code, Cursor) using MCP context and living docs. Benchmarks, prompts, and PR tips—plus how Moxie Docs helps.

  • mcp
  • developer-experience
  • documentation
5 min read

MCP for Agentic Programming: Practical ways AI helps Dev, QA, and Product

A clear overview of MCP and how it powers agentic programming across engineering, QA, and product—with examples and patterns to adopt today.

  • mcp
  • ai-agents
  • developer-experience
5 min read

How We Dogfood a Continuous Documentation Workflow to Keep Code, Docs, and AI in Sync

How we keep code, docs, and AI context in sync with a continuous documentation workflow — and the setup that speeds onboarding.

  • documentation
  • developer-experience
  • engineering-management
5 min read

Stop Writing Novels in Your Wiki: A Minimal Internal Developer Documentation Template That Survives Change

Why wiki pages rot in fast codebases and how a lightweight, git-backed internal developer documentation template keeps docs accurate without busywork.

  • documentation
  • developer-experience
  • engineering-management
5 min read

Automated code documentation that kills onboarding debt

Automated code documentation keeps context current, cuts onboarding time, and stops doc drift from wasting senior engineering hours.

  • documentation
  • developer-experience
  • engineering-management

Put your own repo on the same footing.

Connect a GitHub repository and get searchable docs, MCP-ready context, and Cleanup PRs that keep it all current.

Connect GitHub