diff --git a/Docs/ProjectSpec.md b/Docs/ProjectSpec.md
index 2cd3c461c..34b2574de 100644
--- a/Docs/ProjectSpec.md
+++ b/Docs/ProjectSpec.md
@@ -34,6 +34,7 @@ You can also use environment variables in your configuration file, by using `${S
   - [Legacy Target](#legacy-target)
 - [Aggregate Target](#aggregate-target)
 - [Target Template](#target-template)
+- [Global Template Attributes](#global-template-attributes)
 - [Scheme](#scheme)
   - [Build](#build)
   - [Common Build Action options](#common-build-action-options)
@@ -915,6 +916,15 @@ targetTemplates:
       - ${frameworkName}/${target_name}
 ```
 
+## Global template attributes
+
+This is place to define global variables used to resolve missing `${target_name}` within each template. This also helps share attributes between yaml files.
+
+```yaml
+globalTemplateAttributes:
+  version: legacy
+```
+
 ## Scheme
 
 Schemes allows for more control than the convenience [Target Scheme](#target-scheme) on [Target](#target)