src/FsAutoComplete/FsAutoComplete.fsproj

@@ -87,15 +87,27 @@
 
   <Target Name="BuildAllStandloneApplications">
     <ItemGroup>
+      <!-- Make MSBuild Items out of the RIDs so we can batch across them -->
       <_RIDS Include="$(RuntimeIdentifiers)" />
+      <!-- Make MSBuild Items out of the TFMs so we can batch across them. Create NUM_RIDS items
+      per-TFM because we want to build each TFM for all supported platforms. -->
       <_TFMS
           Include="$(TargetFrameworks)"
           RID="%(_RIDS.Identity)" />
+      <!-- Turn the _TFMS items into requests to build this project (fsautocomplete.fsproj) with
+      different parameters. This pattern is often used to to parallel builds of the same project in
+      MSBuild logic. -->
       <_RIDSpecificFSACBuild
           Include="$(MSBuildThisFile)"
           AdditionalProperties="RuntimeIdentifier=%(_TFMS.RID);TargetFramework=%(_TFMS.Identity)" />
     </ItemGroup>
 
+    <!-- Ask MSBuild to build all of the requests we just made. The MSBuild Task recognizes the
+    AdditionalProperties metadata and will apply that to each specific build, we can specify the things
+    that are common to all of the builds here.  Unsetting RuntimeIdentifiers and TargetFrameworks
+    ensures that the SDK targets detect that these are single-RID/single-TFM builds accurately, and
+    since we're pretty certain there are no data dependencies here we can have the builds operate in
+    parallel. -->
     <MSBuild
         Projects="@(_RIDSpecificFSACBuild)"
         Targets="Publish"