docs: added testing docs for backstage spike

Justfile

@@ -59,6 +59,13 @@ pipeline-tests *args:
     echo "Running tests pipeline..."
     "{{ pipeline_tool }}" --Build:RunTests=true --Release:Mode=None {{ args }}
 
+# Run the pipeline through pack + validate (restore, build, lint, tests, pack, validate pack contents) without publishing/releasing
+[group('Pipeline')]
+pipeline-pack-validate *args:
+    just ensure-pipeline-tool
+    echo "Running pack + validate pipeline..."
+    "{{ pipeline_tool }}" --Build:RunPack=true --Build:ValidatePack=true --Release:Mode=None {{ args }}
+
 # Open the solution in Visual Studio/ Registered application
 [group('Utilities')]
 vs:

docs/wiki/Packaging.md

@@ -94,4 +94,4 @@ are produced. No README is required; if the file is absent the pack succeeds wit
 
 The shared `Purview.Build` pipeline runs package validation on pack (`purview-build.json` sets
 `PackValidation.RequireSymbolPackage=false` for this SDK repo). See
-[Release Flow](Release-Flow.md) for the full flow.
+[Release Flow](Release-Flow.md) for the full flow.

docs/wiki/index.md

@@ -0,0 +1,6 @@
+# Purview Build SDK
+
+Centralized MSBuild conventions, analyzers, code fixes, and repository wiring.
+
+[Documentation overview](Home.md){ .md-button .md-button--primary }
+[Get started](Getting-Started.md){ .md-button }

mkdocs.yml

@@ -0,0 +1,21 @@
+site_name: Purview Build SDK
+site_description: Developer documentation for Purview Build SDK
+repo_url: https://github.com/purview-dev/build-sdk
+edit_uri: edit/main/docs/wiki/
+docs_dir: docs/wiki
+
+theme:
+  name: material
+  palette:
+    - media: "(prefers-color-scheme: light)"
+      scheme: default
+      primary: indigo
+      accent: cyan
+    - media: "(prefers-color-scheme: dark)"
+      scheme: slate
+      primary: indigo
+      accent: cyan
+  features: [navigation.instant, navigation.sections, navigation.top, search.highlight, search.suggest, content.code.copy]
+
+plugins: [search, techdocs-core]
+markdown_extensions: [admonition, attr_list, md_in_html, pymdownx.details, pymdownx.superfences]

purview-build.json

@@ -6,7 +6,22 @@
 		"TestFilter": "/*/*/*/*[Category=Unit]/"
 	},
 	"PackValidation": {
-		"RequireSymbolPackage": false
+		"RequireSymbolPackage": false,
+		"RequiredContent": {
+			"purview.buildsdk": [
+				".agents/**/*",
+				"analyzers/dotnet/cs/Purview.BuildSdk.Analyzers.dll",
+				"analyzers/dotnet/cs/Purview.BuildSdk.CodeFixers.dll",
+				"purview-logo-light.png",
+				"README.md",
+				"Sdk/.editorconfig",
+				"Sdk/Props/Defaults.props",
+				"Sdk/Props/VersionDetection.props",
+				"Sdk/Sdk.props",
+				"Sdk/Sdk.targets",
+				"Sdk/Targets/VersionDetection.targets"
+			]
+		}
 	},
 	"Release": {
 		"Mode": "None"

src/src/BuildSdk/BuildSdk.csproj

@@ -103,7 +103,6 @@
 		/>
 
 		<None Include="$(MSBuildThisFileDirectory)../../../README.md" Pack="true" PackagePath="/" />
-		<None Include="$(MSBuildThisFileDirectory)../../../LICENSE.md" Pack="true" PackagePath="/" />
 		<None
 			Include="$(MSBuildThisFileDirectory)../../../assets/images/purview-logo-light.png"
 			Pack="true"

src/tests/BuildSdk.IntegrationTests/AgentPackFolderTests.cs

@@ -22,11 +22,10 @@ public async Task PurviewAutoSdkPack_PacksPhysicalAndLinkedRootAssets(Cancellati
 			<DisableSourceLink>true</DisableSourceLink>
 			<ExcludePurviewTelemetry>true</ExcludePurviewTelemetry>
 			<PackageReadmeFile>README.md</PackageReadmeFile>
-			<PackageLicenseFile>LICENSE.md</PackageLicenseFile>
+			<PackageLicensesExpression>MIT</PackageLicensesExpression>
 			<PackageIcon>purview-logo-light.png</PackageIcon>
 			""",
 			extraItems: """
-			<None Include="..\LICENSE.md" Link="Sdk\LICENSE.md" />
 			<None Include="..\purview-logo-light.png" Link="Sdk\purview-logo-light.png" />
 			""",
 			cancellationToken: cancellationToken
@@ -38,7 +37,6 @@ await File.WriteAllTextAsync(
 			"# Package",
 			cancellationToken
 		);
-		await File.WriteAllTextAsync(Path.Combine(h.SolutionDirectory, "LICENSE.md"), "License", cancellationToken);
 		await File.WriteAllBytesAsync(
 			Path.Combine(h.SolutionDirectory, "purview-logo-light.png"),
 			[0xFF, 0xD8, 0xFF, 0xD9],
@@ -60,7 +58,6 @@ await File.WriteAllBytesAsync(
 		using var package = await ZipFile.OpenReadAsync(packagePath, cancellationToken);
 		var entries = package.Entries.Select(entry => entry.FullName).ToList();
 		await Assert.That(entries).Contains("README.md");
-		await Assert.That(entries).Contains("LICENSE.md");
 		await Assert.That(entries).Contains("purview-logo-light.png");
 	}