From 7c46d36a288f74bf1fab94e8d47328038a709263 Mon Sep 17 00:00:00 2001
From: Bob Arnson <bob@firegiant.com>
Date: Tue, 17 Sep 2024 13:12:43 -0400
Subject: [PATCH] Document some defaults.

Redo of https://github.com/wixtoolset/web/pull/295 by hand.
---
 src/xsd4/wix.xsd | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/src/xsd4/wix.xsd b/src/xsd4/wix.xsd
index 8bf0e87..cc94fd3 100644
--- a/src/xsd4/wix.xsd
+++ b/src/xsd4/wix.xsd
@@ -2492,12 +2492,12 @@
       </xs:attribute>
       <xs:attribute name="Scope" type="PackageScopeTypeUnion">
         <xs:annotation>
-          <xs:documentation>Use this attribute to specify the installation scope of this package: per-machine, per-user, or a choice of either.</xs:documentation>
+          <xs:documentation>Use this attribute to specify the installation scope of this package: per-machine, per-user, or a choice of either. The default is per-machine.</xs:documentation>
         </xs:annotation>
       </xs:attribute>
       <xs:attribute name="ShortNames" type="YesNoTypeUnion">
         <xs:annotation>
-          <xs:documentation>Indicates whether the package files are installed using 8.3 filenames.</xs:documentation>
+          <xs:documentation>Indicates whether the package files are installed using 8.3 filenames. The default is no.</xs:documentation>
         </xs:annotation>
       </xs:attribute>
       <xs:attribute name="UpgradeCode" type="Guid">
@@ -2508,10 +2508,11 @@
       <xs:attribute name="UpgradeStrategy" type="UpgradeStrategyTypeUnion">
         <xs:annotation>
           <xs:documentation>
+          _New in WiX v5: WiX v5 adds this attribute to the `Package` element._
           The upgrade strategy for the package. If "none," no major upgrade is expected.
           If "majorUpgrade," the UpgradeCode attribute is required and a major upgrade is expected.
+          The default is "majorUpgrade."
           A default major upgrade is automatically provided if none is authored.
-          _New in WiX v5: WiX v5 adds this attribute to the `Package` element._
           </xs:documentation>
         </xs:annotation>
       </xs:attribute>