Blazor high level planning

Outline

BOLD topics written for 0.2.0 release. Sections marked * (asterisk) written for 0.2.0 release.

• ASP.NET Core Blazor (landing page; content: TOC, define & describe Blazor, link out .NET site Get started (set up) content; docs issues, filing bugs/suggestions in Blazor repo, link repo release notes)
  • Build your first Blazor app [one topic (tooling tabs for VS, VS Mac, VSC, CLI); client-server project; downloadable sample]
  • Introduction to Blazor (Ref: Steve's post)
    • Advanced Blazor concepts (advanced technical content)
  • Blazor components (Index topic to hold all initial content)
    • Using Razor*
    • Server-side rendering in code
    • Inline vs code behind*
    • Event handling*
    • Data binding and validation*
    • Rendering child content* (later, render fragments)
    • Building reusable component libraries
    • Logging
    • Error handling
    • Providing parameters*
    • Specifying child content*
    • Routing*
    • Built-in Blazor components
      • NavLink
  • Blazor layouts
    • Defining layouts*
    • Using layouts*
  • Dependency injection in Blazor
    • Configuring services*
    • Resolving services*
    • Built-in services*
  • Blazor app and component life cycle
    • StateHasChanged
  • JavaScript and TypeScript interop in Blazor (e.g., https://github.com/aspnet/Blazor/issues/348)
  • Blazor app and session state (https://github.com/aspnet/Blazor/pull/205)
  • Test and debug Blazor apps
    • Blazor development-time testing (live reloading #193)
    • Blazor unit testing
  • Blazor data access
  • Blazor security
  • Blazor performance
  • Blazor analytics
  • Host and deploy Blazor
    • Link Servers, Hosting, and Host and deploy topics in ASP.NET Core docs to cover server-side deployment
    • Standalone deployments* (if needed, notes on Azure CDN, file server, GitHub Pages)
    • Hosting in ASP.NET Core*
    • Publishing*
    • IL trimming*
    • Blazor directory structure (https://github.com/aspnet/Blazor/issues/413)
    • Deployment of Blazor to non-WebAssembly browsers (asm.js)
  • Troubleshoot Blazor
    • Blazor common errors reference

Notes

• Blazor topics titles will contain "Blazor" as the technology name (and not "ASP.NET Core"). Where possible, the name will be prefixed to the content name (e.g., "Blazor components", "Blazor Security," "Blazor Routing"). In some cases, "Blazor" works better inline (e.g, "Build a Blazor app with Visual Studio"). Links within topics won't include "Blazor" (e.g., "To learn more, see the [Components](xref:xxxx) topic.").
• No doc stubs
• "Blazor is preview" INCLUDE notice on every topic
• No work-in-progress or upcoming features lists
• Developers land on Build your first Blazor app from the .NET site pages
• Release notes will be maintained in the Blazor repo
• FAQ will be maintained in the Blazor repo Wiki

Initial topics

1. ASP.NET Core Blazor (landing page)
2. Introduction to Blazor: Index
3. Blazor components: Index
4. Blazor layouts: Index
5. Dependency injection in Blazor
6. Tutorials: index; Build your first Blazor app (4 topic group)
7. Host and deploy Blazor: Index