From e296f26c765975bf68615765a1bde987c913e3ce Mon Sep 17 00:00:00 2001
From: Drew Noakes <git@drewnoakes.com>
Date: Wed, 3 Sep 2025 11:12:03 +1000
Subject: [PATCH] Doc that capabilities cannot come from DTB

---
 doc/overview/about_project_capabilities.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/doc/overview/about_project_capabilities.md b/doc/overview/about_project_capabilities.md
index 8dd8655..96585bc 100644
--- a/doc/overview/about_project_capabilities.md
+++ b/doc/overview/about_project_capabilities.md
@@ -43,6 +43,9 @@ being to add this MSBuild item to your `.targets` file:
 </ItemGroup>
 ```
 
+> [!IMPORTANT]
+> Project capabilites cannot be added during design-time builds. They must be added via evaluation, or via code.
+
 ## Defining fixed capabilities for a project type
 
 Some capabilities are static/fixed for a given project type. These capabilities should be defined directly on the project type registration.