Skip to main content

Allow annotations to display linked documentation

  • May 7, 2026
  • 0 replies
  • 9 views

Lili Liang

We’ve been moving toward a D2C workflow, and we found that component documentation is great context for AI, so we’re starting to put specs and behavior definitions there.

The problem is that we also want this to work as shared documentation for designers and engineers, but right now it’s not very visible in either Design Mode or Dev Mode, so people may never discover it.

Annotations could help surface it, but since they can’t display the documentation directly yet, the only workaround is to duplicate the content there—which breaks the single source of truth.

Therefore, it would be helpful if annotations could directly surface linked documentation content.