> Markdown version of [https://nikhilajain.com/blog/](https://nikhilajain.com/blog/). Latest field notes # Thinking about documentation as the knowledge layer behind AI My perspective on how documentation architecture, engineering workflows, and AI systems fit together. My point of view ## AI quality depends on the knowledge system behind the answer AI does not make documentation architecture less important. It makes the underlying choices visible: which source is trusted, what context is available, how an agent is guided, and how a team knows when an answer is wrong. I think about documentation as the maintained knowledge layer that connects product change to useful answers for people and AI. [Read the architecture](/blog/posts/engineering-documentation-for-ai/) ### Context Give the system the right source, version, audience, permissions, and task context. ### Skills Keep agent instructions scoped, versioned, and connected to authoritative documentation. ### Harnesses Test realistic user tasks for retrieval quality, grounding, and reliable completion. ### Traces Inspect sources, context, tools, and outputs to locate where a failure entered the flow. ## Documentation Systems [Tutorial Documentation Systems Updated: July 2026 ### GitHub for writers: Navigating pull request reviews Learn how pull request reviews work in GitHub. Understand review comments, approvals, requested changes, and how technical writers collaborate confidently using GitHub workflows.](/blog/posts/github-for-writers-collaborating-with-pr-reviews/) [Tutorial Documentation Systems Updated: January 2026 ### GitHub for writers: Branches and Pull Requests Learn Git branches and pull requests for documentation. Master the complete workflow from creating branches to submitting PRs—no command line required.](/blog/posts/github-for-writers-branching-and-prs/) [Tutorial Documentation Systems Updated: January 2026 ### GitHub for Documentation: The Complete Guide for Technical Writers Master GitHub for documentation with this step-by-step guide. Learn version control, collaboration, and docs-as-code workflows without touching the command line.](/blog/posts/github-for-writers-no-git-commands-needed/) [Tutorial Documentation Systems Updated: December 2025 ### Create Your First Docusaurus Documentation Website Learn how to create a professional Docusaurus documentation website from scratch. This step-by-step tutorial covers setup, configuration, and deployment for beginners.](/blog/posts/create-your-first-docusaurus-documentation-website/) [Tutorial Documentation Systems January 2025 ### How to Install Vale Linter in VS Code for Documentation (2026 Guide) Set up Vale linter in VS Code to automatically check documentation for style, grammar, and consistency issues. Includes CI hooks and contributor setup.](/blog/posts/how-to-install-vale-linter-for-documentation-in-vs-code/) [How-to Guide Documentation Systems January 2025 ### Docusaurus Multiple Sidebars: Complete Setup Guide with Code Examples Learn to set up multiple sidebars in Docusaurus for multi-product documentation portals. Step-by-step guide with code examples and best practices.](/blog/posts/how-to-set-up-multiple-sidebars-in-docusaurus/) ## AI & Documentation [Documentation architecture AI & Documentation November 2026 ### How to Make Your Documentation AI-Ready Learn how to prepare documentation for AI search, RAG, and agents: audit sources, improve structure, manage context, and test answers.](/blog/posts/engineering-documentation-for-ai/) [How-to Guide AI & Documentation January 2025 ### How to Write User-Focused Documentation Learn how to create effective user-focused documentation with practical tips on developing user personas, mapping content to the user's journey, and incorporating a feedback loop. Enhance your documentation to better support and guide users through their experience.](/blog/posts/how-to-write-user-focused-documentation/) [Thought leadership AI & Documentation January 2025 ### Should You Migrate Your Documentation System — and Is It AI-Ready? Is my documentation AI-ready? Scalable, AI-native docs require more than great writing — they need systems built for scale, reuse, and machine understanding.](/blog/posts/is-my-documentation-ai-ready/) ## Developer Experience [Tutorial Developer Experience January 2025 ### How to Create Java Micronaut Microservice? Micronaut is a modern, JVM based framework to build Microservices. Get started and build your first Java Micronaut Microservice.](/blog/posts/java-micronaut-microservice/) [Tutorial Developer Experience January 2025 ### Python for Mobile App Development: An In-Depth Look at Popular Frameworks Learn how to create powerful, cross-platform mobile apps using Python with our in-depth guide. Discover the best frameworks, libraries, and tools for building mobile apps with Python. Optimize for SEO and improve your app's discoverability.](/blog/posts/mobile-apps-using-python/) [How-to Guide Developer Experience January 2025 ### Set JAVA_HOME on Windows, Mac, Linux and Unix Learn the step-by-step process of setting JAVA_HOME environment variable on different operating systems such as Mac, Windows, Linux, and Unix. Ensure smooth running of Java applications by correctly setting JAVA_HOME with this easy guide.](/blog/posts/set-java-home/) [Concept Developer Experience August 2020 ### How to Design User Role Permission Model? A comprehensive guide to modeling user role permission systems using RBAC and ABAC approaches, with implementation examples and use cases.](/blog/posts/user-role-permission-model/) ## Technical Leadership [Concept Technical Leadership January 2025 ### Scrum Vs Agile: Understanding the Key Differences Learn about the key differences between Scrum and Agile frameworks, including the roles of the Scrum Master and Agile Coach, and how they approach project management and team collaboration. Discover which approach is best for your team and projects.](/blog/posts/scrum-vs-agile/)