Annotations

Annotations lets you attach structured notes to any part of a Drupal site: content types, custom entities, individual fields, vocabularies, roles, etc. Those notes live in one place and can be exposed wherever you need them.

It is a context-driven, organic documentation layer that stays with your site, that your users and AI can use - accumulated domain-specific knowledge. A Context Management System, if you will...

Annotation entities offer the full gamut of Drupal's flexibility, with built-in fieldability, revisions, translation, workflows etc.

Annotations doesn't touch your content, change your content model, or add fields to anything else. It's a metadata layer that sits alongside your existing setup.

What it can do:

• Attach editorial guidance, technical notes, or business logic to any entity type or field in your site
• Surface those notes as in-context overlays on edit forms, so content editors have guidance exactly when they need it
• Assemble them into a structured context payload for AI tools & agents, handing your AI agent an accurate, knowledge-filled map of your site
• Track annotation coverage so you know what's documented and what's not
• Generate/export documentation for onboarding packs, handover docs, etc from your annotation content
• Command line tools - think, a man page for your entity types

Annotations uses a slightly different access model in that it is conceptually divided into two camps: management and consumption. The core modules are the annotation management modules, the remainder are consumer modules. The permissions exposed by it reflect this. More in the README(s).