fix(docs): include generated code snippets as the embedded resources (#…

…71)

* ci(deploy-stage): fix slot name

* ci(deploy-stage): rename environment

* build(docs): trying to resolve an issue related with missing code snippets

* ci(deploy): perform a build of the entire solution

* ci(deploy): build only components;

Building the entire solution before publishing affected code snippets inclusion for some reason...

.github/workflows/deploy-stage.yml

@@ -36,7 +36,7 @@ jobs:
     runs-on: ubuntu-latest
     needs: build
     environment:
-      name: 'Staging'
+      name: 'staging'
       url: ${{ steps.deploy-to-webapp.outputs.webapp-url }}
     permissions:
       id-token: write #This is required for requesting the JWT
@@ -59,6 +59,6 @@ jobs:
         uses: azure/webapps-deploy@v3
         with:
           app-name: 'lumexui'
-          slot-name: 'Staging'
+          slot-name: 'staging'
           package: .
 

.github/workflows/deploy.yml

@@ -23,7 +23,7 @@ jobs:
         with:
           dotnet-version: '8.0.x'
 
-      - name: Build LumexUI
+      - name: Build components
         run: dotnet build ./src/LumexUI -c Release
 
       - name: Publish

docs/LumexUI.Docs/LumexUI.Docs.Client/LumexUI.Docs.Client.csproj

@@ -13,13 +13,13 @@
 	</ItemGroup>
 
 	<ItemGroup>
-		<EmbeddedResource Include="Pages/**/*.html" />
-		<EmbeddedResource Include="Samples/**/*.html" />
+	  <ProjectReference Include="..\..\..\src\LumexUI.Utilities\LumexUI.Utilities.csproj" />
+	  <ProjectReference Include="..\..\..\src\LumexUI\LumexUI.csproj" />
 	</ItemGroup>
 
 	<ItemGroup>
-	  <ProjectReference Include="..\..\..\src\LumexUI.Utilities\LumexUI.Utilities.csproj" />
-	  <ProjectReference Include="..\..\..\src\LumexUI\LumexUI.csproj" />
+		<EmbeddedResource Include="Pages/**/*.html" />
+		<EmbeddedResource Include="Samples/**/*.html" />
 	</ItemGroup>
 
 </Project>

docs/LumexUI.Docs/LumexUI.Docs/LumexUI.Docs.csproj

@@ -28,18 +28,9 @@
 	</ItemGroup>
 
 	<!-- Run the docs content generation command -->
-	<Target Name="DocsGenerator" BeforeTargets="Compile">
+	<Target Name="DocsGenerator" BeforeTargets="BeforeBuild">
 		<Exec Command="$(DocsGeneratorProject)" />
 	</Target>
-
-	<Target Name="VerifyGeneratedFiles" AfterTargets="DocsGenerator" BeforeTargets="Compile">
-		<ItemGroup>
-			<GeneratedFiles Include="$(SolutionDir)docs/LumexUI.Docs/LumexUI.Docs.Client/Pages/**/*.html" />
-		</ItemGroup>
-		<Message Text="Generated files are:" Condition=" @(GeneratedFiles->Count()) > 0 " Importance="high" />
-		<Message Text="%(GeneratedFiles.Identity)" Condition=" @(GeneratedFiles->Count()) != 0 " Importance="high" />
-		<Error Text="Generated files are missing." Condition=" @(GeneratedFiles->Count()) == 0 " />
-	</Target>
 
 	<!-- Install npm dependencies if 'node_modules' is not present -->
 	<Target Name="Npm" AfterTargets="DocsGenerator" Condition="!Exists('node_modules')">