# Documentation needs a revolution Right now, AI is already so capable, and it's only accelerating. Just between December and now, there was a huge leap in model/harness efficiency. Meanwhile, documentation still remains very poor, both at a personal level and at the team/service/department/organization level. And I feel like that's a missed opportunity to leverage knowledge WITH AI, providing it with ease of access to relevant/valuable context. The more AI knows about your goals, projects, tasks, priorities, processes, architecture, decisions, ..., the more helpful it can be. So I'm wondering: what are the ways to tackle this at the different levels? When it comes to individuals, I know the answer; it's called [[Personal Knowledge Management (PKM)]]. It's a topic I've been extensively focusing on during the last few years. When it comes to teams/services/departments & the whole organization, it's comes down to creating single sources of truth at the different levels; so-called [[Information Radiators]], removing the "where should I put this?" question, and making it straightforward for everyone to actually write and leverage documentation. The goal is also to create shared spaces where strategy, goals, projects, tasks, priorities, decisions & ideas are centralized & visible; where individual focus is also visible (e.g., answering questions such as who is handling X right now? Is this support request being taken care of? etc). In both cases, ideally, storing the information as simple text/Markdown content provides most leverage since it makes it a breeze for AI to consume. And in both cases, the fewer information "silos" there are, the better. Less is more when it comes to information/knowledge storage. This also applies to technical documentation about software, systems, infrastructures, etc. But this touches on more technical details around how AI finds its way through a codebase/system, and how to best leverage it. ## References - ## Related - [[Personal Knowledge Management (PKM)]] - [[Information Management (IM)]] - [[Information Radiators]] - [[Single Source of Truth (SSOT)]] - [[Markdown]] - [[Artificial Intelligence (AI)]]