Skip to content

Commit 5ff7da4

Browse files
authored
Getting started docs update (#26)
* Landing page - Layout updates * .NET 8 - WebAssembly - Getting started updates * Update documentation structure and installation snippets - Refactor `BlazorExpress.Bulma.Demo.RCL.csproj` to move documentation snippets to `Pages\Docs\GettingStarted\net8\`. - Update manual installation snippets to include necessary commands and references for `BlazorExpress.Bulma`. - Revise getting started documentation for .NET 8 WebAssembly, WebApp Server, WebApp Auto, and MAUI with clearer installation and usage instructions. - Ensure code snippets reflect the new structure for easier setup and usage of the `BlazorExpress.Bulma` library. * Update documentation for .NET 8 and restructure sections - Revamped `BlazorExpress.Bulma.Demo.RCL.csproj` to include new content and remove outdated files for .NET 8. - Significant updates to `GettingStarted_02_NET_8_WebApp_Server_Documentation.razor`, including reformatting prerequisites and dotnet template instructions into new `Section` components. - Enhanced manual installation instructions with clearer formatting and additional code snippets. - Reformatted troubleshooting and references sections for improved clarity and consistency. - Added new snippets demonstrating installation and usage of the `BlazorExpress.Bulma` package. * Comment out links for future implementation In `DocsMainLayout.razor.cs`, commented out links for "Blazor WebApp (.NET 8) Auto" and "MAUI Blazor Hybrid App (.NET 8)" to preserve code for potential future use. In `GettingStartedDocumentation.razor`, replaced links for "Blazor WebApp (.NET 8) - Interactive render mode Auto - Global location" and "MAUI Blazor Hybrid App (.NET 8)" with "TODO" placeholders to indicate sections needing future attention.
1 parent 3954565 commit 5ff7da4

22 files changed

Lines changed: 271 additions & 234 deletions

BlazorExpress.Bulma.Demo.RCL/BlazorExpress.Bulma.Demo.RCL.csproj

Lines changed: 10 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -7,19 +7,16 @@
77
</PropertyGroup>
88

99
<ItemGroup>
10-
<Content Remove="Pages\Docs\GettingStarted\01_A_Manual_Install_04_Snippet.razor" />
11-
</ItemGroup>
12-
13-
<ItemGroup>
14-
<None Include="Pages\Docs\GettingStarted\01_A_Manual_Install_04_Snippet.razor" />
15-
</ItemGroup>
16-
17-
<ItemGroup>
18-
<Compile Remove="Pages\Docs\GettingStarted\01_A_Manual_Install_05_Snippet.cs" />
19-
</ItemGroup>
20-
21-
<ItemGroup>
22-
<Content Include="Pages\Docs\GettingStarted\01_A_Manual_Install_05_Snippet.cs" />
10+
<!-- .NET 8 / Web Assembly -->
11+
<Content Remove="Pages\Docs\GettingStarted\net8\01_A_Manual_Install_04_Snippet.razor" />
12+
<None Include="Pages\Docs\GettingStarted\net8\01_A_Manual_Install_04_Snippet.razor" />
13+
<Compile Remove="Pages\Docs\GettingStarted\net8\01_A_Manual_Install_05_Snippet.cs" />
14+
<Content Include="Pages\Docs\GettingStarted\net8\01_A_Manual_Install_05_Snippet.cs" />
15+
<!-- .NET 8 / Server -->
16+
<Content Remove="Pages\Docs\GettingStarted\net8\02_A_Manual_Install_04_Snippet.razor" />
17+
<None Include="Pages\Docs\GettingStarted\net8\02_A_Manual_Install_04_Snippet.razor" />
18+
<Compile Remove="Pages\Docs\GettingStarted\net8\02_A_Manual_Install_05_Snippet.cs" />
19+
<Content Include="Pages\Docs\GettingStarted\net8\02_A_Manual_Install_05_Snippet.cs" />
2320
</ItemGroup>
2421

2522
<ItemGroup>

BlazorExpress.Bulma.Demo.RCL/Layout/DocsMainLayout.razor.cs

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -41,8 +41,8 @@ private HashSet<LinkGroup> GetLinkGroups()
4141
new Link { Href = RouteConstants.Docs_Getting_Started_Introduction, Text = "Introduction" },
4242
new Link { Href = RouteConstants.Docs_Getting_Started_WebAssembly_NET_8, Text = "Blazor WebAssembly (.NET 8)" },
4343
new Link { Href = RouteConstants.Docs_Getting_Started_WebApp_Server_NET_8, Text = "Blazor WebApp (.NET 8) Server" },
44-
new Link { Href = RouteConstants.Docs_Getting_Started_WebApp_Auto_NET_8, Text = "Blazor WebApp (.NET 8) Auto" },
45-
new Link { Href = RouteConstants.Docs_Getting_Started_MAUI_NET_8, Text = "MAUI Blazor Hybrid App (.NET 8)" },
44+
//new Link { Href = RouteConstants.Docs_Getting_Started_WebApp_Auto_NET_8, Text = "Blazor WebApp (.NET 8) Auto" },
45+
//new Link { Href = RouteConstants.Docs_Getting_Started_MAUI_NET_8, Text = "MAUI Blazor Hybrid App (.NET 8)" },
4646
]
4747
});
4848

BlazorExpress.Bulma.Demo.RCL/Layout/MainLayout.razor

Lines changed: 7 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -10,15 +10,13 @@
1010
<ContentSection>
1111
@Body
1212
<div class="container is-max-desktop mb-4">
13-
<div class="px-5">
14-
<Notification Class="has-text-centered" Color="NotificationColor.Link" HideDeleteButton="true">
15-
<a href="@GithubUrl" class="be-bulma-text-decoration-none" target="_blank">
16-
<i class="bi bi-star-fill"></i>
17-
<span>If you like BlazorExpress.Bulma, give it a star on GitHub!</span>
18-
<i class="bi bi-star-fill"></i>
19-
</a>
20-
</Notification>
21-
</div>
13+
<Notification Class="has-text-centered" Color="NotificationColor.Link" HideDeleteButton="true">
14+
<a href="@GithubUrl" class="be-bulma-text-decoration-none" target="_blank">
15+
<i class="bi bi-star-fill"></i>
16+
<span>If you like BlazorExpress.Bulma, give it a star on GitHub!</span>
17+
<i class="bi bi-star-fill"></i>
18+
</a>
19+
</Notification>
2220
<MainLayoutBaseFooter Version="@Version"
2321
DotNetVersion="@DotNetVersion"
2422
DocsUrl="@DocsUrl"

BlazorExpress.Bulma.Demo.RCL/Pages/Docs/GettingStarted/GettingStartedDocumentation.razor

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -38,12 +38,14 @@
3838
<tr>
3939
<td>3</td>
4040
<td>.NET 8</td>
41-
<td><a href="/docs/getting-started/blazor-webapp-auto-global-net-8">Blazor WebApp (.NET 8) - Interactive render mode Auto - Global location</a></td>
41+
@* <td><a href="/docs/getting-started/blazor-webapp-auto-global-net-8">Blazor WebApp (.NET 8) - Interactive render mode Auto - Global location</a></td> *@
42+
<td>TODO: Blazor WebApp (.NET 8) - Interactive render mode Auto - Global location</td>
4243
</tr>
4344
<tr>
4445
<td>4</td>
4546
<td>.NET 8</td>
46-
<td><a href="/docs/getting-started/maui-blazor-net-8">MAUI Blazor Hybrid App (.NET 8)</a></td>
47+
@* <td><a href="/docs/getting-started/maui-blazor-net-8">MAUI Blazor Hybrid App (.NET 8)</a></td> *@
48+
<td>TODO: MAUI Blazor Hybrid App (.NET 8)</td>
4749
</tr>
4850
</tbody>
4951
</table>

BlazorExpress.Bulma.Demo.RCL/Pages/Docs/GettingStarted/GettingStarted_01_NET_8_WebAssembly_Documentation.razor

Lines changed: 0 additions & 90 deletions
This file was deleted.

BlazorExpress.Bulma.Demo.RCL/Pages/Docs/GettingStarted/GettingStarted_02_NET_8_WebApp_Server_Documentation.razor

Lines changed: 0 additions & 118 deletions
This file was deleted.

BlazorExpress.Bulma.Demo.RCL/Pages/Docs/GettingStarted/01_A_Manual_Install_01_Snippet.razor renamed to BlazorExpress.Bulma.Demo.RCL/Pages/Docs/GettingStarted/net8/01_A_Manual_Install_01_Snippet.razor

File renamed without changes.

BlazorExpress.Bulma.Demo.RCL/Pages/Docs/GettingStarted/01_A_Manual_Install_02_Snippet.html renamed to BlazorExpress.Bulma.Demo.RCL/Pages/Docs/GettingStarted/net8/01_A_Manual_Install_02_Snippet.html

File renamed without changes.

BlazorExpress.Bulma.Demo.RCL/Pages/Docs/GettingStarted/01_A_Manual_Install_03_Snippet.html renamed to BlazorExpress.Bulma.Demo.RCL/Pages/Docs/GettingStarted/net8/01_A_Manual_Install_03_Snippet.html

File renamed without changes.

BlazorExpress.Bulma.Demo.RCL/Pages/Docs/GettingStarted/01_A_Manual_Install_04_Snippet.razor renamed to BlazorExpress.Bulma.Demo.RCL/Pages/Docs/GettingStarted/net8/01_A_Manual_Install_04_Snippet.razor

File renamed without changes.

0 commit comments

Comments
 (0)