[planning] Repository design and planning

[adegeo]

The content this repo hosts is product documentation related to WPF and WinForms. This content is currently hosted in dotnet/docs repo and is really focused on .NET Framework. With WPF and WinForms going open source and those versions targeting .NET Core/5+ (further referred to as simply ".NET"), the .NET Framework content will be copied and updated. This means that the repo will be designed to host versioned content with the major separator being .NET Framework and .NET.

Versioning

The version monikers will be:

• .NET Framework 4.x
• .NET 5 / .NET Core 3.1

The framework folder will be versioned at .NET Framework 4.x and the net folder will be versioned with .NET 5.

Folder structure

The content will be structured as follows:

• root
  • framework
    • wpf
    • winforms
    • shared
  • net
    • wpf
    • winforms
    • shared

The framework folder represents the content migrated from the dotnet/docs repos for both WPF and WinForms. The net folder represents the .NET 5+/.NET Core 3.1

The shared folders represent articles shared across wpf and winforms. For example, creating an MSIX package will probably be the same for both .NET 5 WPF and .NET 5 WinForms apps.

Tasks

Repo specific

• Create labels (ported from dotnet/docs)
• New issue templates
• License for .NET Foundation
• Setup auto labeler
• Readme update
• Add whats-new system
• Convert root page to hub
• Setup loc
• Add rules for xaml-services in ghal

Initial publish winforms

• Move framework winforms content (.NET Framework WinForms content migration #4)
• Create breadcrumbs (Breadcrumb / TOC / Move net5 to net folder #15)
• Create placeholder .net 5 winforms content (Add .net 5 winforms placeholder article #16)
• Merge working branch of .net 5 winforms content into master
• Update metadata (Add .net 5 winforms placeholder article #16)
• Landing pages (Add .net 5 winforms placeholder article #16) (more)
• Update links in dotnet hub pages
• Merge delete/redirects of dotnet/docs content (Move desktop winforms to new repo docs#20279)
• Publish (Initial publish of WinForms for .NET 5. #96)

Winforms

• Move winform content planning issues from dotnet/docs here
• Determine if we'll publish some of the content had add "Preview content" banners
• Clean up dotnet/docs repo links in existing files (ensure local links are changed and don't rely on redirects)
• Clean up api ref links

Initial publish WPF

• Move framework WPF content (Initial WPF content migrated #17)
• Create breadcrumbs (Initial WPF content migrated #17)
• Landing pages
• Update links in dotnet hub pages (Move WPF content to new repo docs#20445)
• Merge delete/redirects of dotnet/docs content (Move WPF content to new repo docs#20445)
• Publish

WPF

• Move old desktop-guide wpf content as .NET 5 (Migrate WPF .NET Core 3.1 content to desktop guide docs#20678)
• File issues for new WPF content plan
• Move XAML-SERVICES content (Migrate WPF .NET Core 3.1 content to desktop guide docs#20678)
• Clean up dotnet/docs repo links in existing files (ensure local links are changed and don't rely on redirects)
• Clean up api ref links