Introduce PublishRuntimeIdentifier

src/Tests/Microsoft.NET.TestFramework/ProjectConstruction/TestProject.cs

@@ -20,6 +20,9 @@ public TestProject([CallerMemberName] string name = null)
             }
         }
 
+        /// <summary>
+        /// A custom nametag for the project that's appended to a root test folder. By default, it is the unhashed name of the function that instantiated the TestProject object.
+        /// </summary>
         public string Name { get; set; }
 
         public bool IsSdkProject { get; set; } = true;

src/Tests/Microsoft.NET.TestFramework/TestAsset.cs

@@ -21,6 +21,9 @@ public class TestAsset : TestDirectory
 
         public string TestRoot => Path;
 
+        /// <summary>
+        /// The hashed test name (so file paths do not become too long) of a particular test. This will be the root of the test folder. 
+        /// </summary>
         public readonly string Name;
 
         public ITestOutputHelper Log { get; }

src/Tests/Microsoft.NET.TestFramework/TestAssetsManager.cs

@@ -52,6 +52,15 @@ public TestAsset CopyTestAsset(
             return testAsset;
         }
 
+        /// <summary>
+        /// 
+        /// </summary>
+        /// <param name="testProject">The testProject used to create a teatAsset with.</param>
+        /// <param name="callingMethod">Defaults to the name of the caller function (presumably the test). Used to prevent file collisions on tests which share the same test project.</param>
+        /// <param name="identifier">An ID for the project that should be unique for every test, including each theory child test.
+        /// This is distinct from the test project name and is used to prevent file collisions between theory tests that use the same test project.</param>
+        /// <param name="targetExtension">The extension type of the desired test project, e.g. .csproj, or .fsproj.</param>
+        /// <returns></returns>
         public TestAsset CreateTestProject(
             TestProject testProject,
             [CallerMemberName] string callingMethod = "",