Initial publish

.github/ISSUE_TEMPLATE/config.yml

@@ -6,3 +6,6 @@ contact_links:
   - name: .NET platform and other product feedback
     url: https://developercommunity.visualstudio.com/spaces/61/index.html
     about: Log product issues here
+  - name: .NET Breaking Change
+    url: https://github.com/dotnet/docs/issues/new?assignees=&labels=&template=dotnet-breaking-change.md&title=
+    about: Breaking changes are documented in the .NET docs repo.

.github/ISSUE_TEMPLATE/doc-issue.md

@@ -5,32 +5,40 @@ about: Report a problem in the .NET documentation
 
 **Before you open an issue**
 
+(Delete this section before you submit your issue)
+
 If the issue is:
 
-- A simple typo or similar correction, consider submitting a PR to fix it instead of logging an issue. See [the contributor guide](https://docs.microsoft.com/contribute/#quick-edits-to-existing-documents) for instructions.
-- A general support question, consider asking on a support forum site.
-- A site design concern, create an issue at [MicrosoftDocs/feedback](https://github.com/MicrosoftDocs/feedback/issues/new/choose).
+- A simple typo or similar correction, consider submitting a PR to fix it instead of logging an issue. See https://docs.microsoft.com/contribute/#quick-edits-to-existing-documents for instructions
+
+- A general support question, consider asking on a support forum site such as StackOverflow.
+
+- A site design concern, create an issue at https://github.com/MicrosoftDocs/feedback/issues/new/choose
+
 - A problem completing a tutorial, compare your code with the completed sample.
+
 - A duplicate of an open or closed issue, leave a comment on that issue.
 
+(Delete the content above before you submit your issue)
+
 **Issue description**
 
-<include description here>
+Include description here
 
-**Target framework**
+**.NET or .NET Framework**
 
-Check the .NET target framework(s) being used, and include the version number(s).
+Check the .NET target framework(s) being used, and include the version number(s). Put an `x` between the `[ ]` to check it.
 
-- [ ] .NET Core
+- [ ] .NET (5 or Core)
 - [ ] .NET Framework
-- [ ] .NET Standard
 
-If using the .NET Core SDK, include `dotnet --info` output. If using .NET Framework without the .NET Core SDK, include info from Visual Studio's **Help** > **About Microsoft Visual Studio** dialog.
+**Technology**
+
+Check the .NET target framework(s) being used, and include the version number(s). Put an `x` between the `[ ]` to check it.
+
+- [ ] WPF
+- [ ] Windows Forms
 
-<details>
-<summary><strong>dotnet --info output</strong> or <strong>About VS info</strong></summary>
+**.NET information**
 
-```console
-<replace>
-```
-</details>
+If using the .NET SDK or .NET Core SDK, include `dotnet --info` output. If using .NET Framework without the .NET Core SDK, include info from Visual Studio's **Help** > **About Microsoft Visual Studio** dialog.

.openpublishing.publish.config.json

@@ -5,8 +5,7 @@
       "build_source_folder": "dotnet-desktop-guide",
       "build_output_subfolder": "dotnet-desktop-guide",
       "locale": "en-us",
-      "monikers": [],
-      "moniker_ranges": [],
+      "moniker_ranges": ["netframeworkdesktop-4.8", "netdesktop-5.0"],
       "filemap_share_depots": [
         "VS.dotnet-api-docs"
       ],

README.md

@@ -1,3 +1,22 @@
-## Microsoft Open Source Code of Conduct
-This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
-For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
+# .NET Desktop Guide docs
+
+![Markdownlint](https://github.com/dotnet/docs-desktop/workflows/Markdownlint/badge.svg)
+
+This repository contains the conceptual documentation for .NET desktop technologies, such as Windows Presentation Foundation (WPF) and Windows Forms (WinForms). It's published at the [.NET Desktop Guide documentation site](https://docs.microsoft.com/dotnet/desktop).
+
+## Issues
+
+We have a large community using these resources. We make our best effort to respond to issues in a timely fashion. You can read more about our procedures for classifying and resolving issues in our [Issues policy](issues-policy.md) topic.
+
+We welcome contributions to help us improve and complete the .NET docs. This is a very large repo, covering a large area. If this is your first visit, see our [labels and projects roadmap](styleguide/labels-projects.md) for help navigating the issues and projects in this repository.
+
+## Migrate old examples
+
+If you're interested in helping migrate existing code that targets the .NET Framework (specifically WPF and WinForms) from the [retired Code Gallery](https://docs.microsoft.com/teamblog/msdn-code-gallery-retired) site to .NET Core applications stored in our [samples repository](https://github.com/dotnet/samples) and downloadable from the [Samples Browser](https://docs.microsoft.com/samples/browse), see the [Code Gallery migration](https://github.com/dotnet/docs/projects/88) project. The code gallery samples were moved to the [Microsoft Archive](https://github.com/microsoftarchive?q=msdn-code-gallery) organization.
+
+## Code of Conduct
+
+This project has adopted the code of conduct defined by the Contributor Covenant
+to clarify expected behavior in our community.
+
+For more information, see the [.NET Foundation Code of Conduct](https://dotnetfoundation.org/code-of-conduct).

dotnet-desktop-guide/TOC.yml

@@ -1,2 +1,8 @@
-- name: Index
-  href: index.md
+items:
+- name: Windows Forms
+  expanded: true
+  items:
+  - name: ".NET 5 (and .NET Core 3.1)"
+    href: https://docs.microsoft.com/dotnet/desktop/winforms/?view=netdesktop-5.0
+  - name: .NET Framework
+    href: https://docs.microsoft.com/dotnet/desktop/winforms/?view=netframework-4-8

dotnet-desktop-guide/docfx.json

@@ -16,7 +16,53 @@
           "README.md",
           "LICENSE",
           "LICENSE-CODE",
-          "ThirdPartyNotices.md"
+          "ThirdPartyNotices.md",
+          "samples/**/*.*"
+        ],
+        "group": "framework",
+        "src": "framework"
+      },
+      {
+        "files": [
+          "**/*.md",
+          "**/*.yml"
+        ],
+        "exclude": [
+          "**/obj/**",
+          "**/includes/**",
+          "_themes/**",
+          "_themes.pdf/**",
+          "**/docfx.json",
+          "_repo.en-us/**",
+          "README.md",
+          "LICENSE",
+          "LICENSE-CODE",
+          "ThirdPartyNotices.md",
+          "samples/**/*.*"
+        ],
+        "group": "net",
+        "src": "net"
+      },
+      {
+        "files": [
+          "**/*.md",
+          "**/*.yml"
+        ],
+        "exclude": [
+          "framework",
+          "net",
+
+          "**/obj/**",
+          "**/includes/**",
+          "_themes/**",
+          "_themes.pdf/**",
+          "**/docfx.json",
+          "_repo.en-us/**",
+          "README.md",
+          "LICENSE",
+          "LICENSE-CODE",
+          "ThirdPartyNotices.md",
+          "samples/**/*.*"
         ]
       }
     ],
@@ -33,18 +79,60 @@
           "_themes/**",
           "_themes.pdf/**",
           "**/docfx.json",
-          "_repo.en-us/**"
+          "_repo.en-us/**",
+          "samples/**/*.*"
+        ],
+        "group": "framework",
+        "src": "framework"
+      },
+      {
+        "files": [
+          "**/*.png",
+          "**/*.gif",
+          "**/*.jpg"
+        ],
+        "exclude": [
+          "**/obj/**",
+          "**/includes/**",
+          "_themes/**",
+          "_themes.pdf/**",
+          "**/docfx.json",
+          "_repo.en-us/**",
+          "samples/**/*.*"
+        ],
+        "group": "net",
+        "src": "net"
+      },
+      {
+        "files": [
+          "**/*.png",
+          "**/*.gif",
+          "**/*.jpg"
+        ],
+        "exclude": [
+          "framework",
+          "net",
+
+          "**/obj/**",
+          "**/includes/**",
+          "_themes/**",
+          "_themes.pdf/**",
+          "**/docfx.json",
+          "_repo.en-us/**",
+          "samples/**/*.*"
         ]
       }
     ],
     "overwrite": [],
     "externalReference": [],
     "globalMetadata": {
       "breadcrumb_path": "/dotnet/desktop/breadcrumb/toc.json",
-      "extendBreadcrumb": true,
+      "extendBreadcrumb": false,
       "feedback_system": "GitHub",
       "feedback_github_repo": "dotnet/docs-desktop",
-      "feedback_product_url": "https://developercommunity.visualstudio.com/spaces/61/index.html"
+      "feedback_product_url": "https://developercommunity.visualstudio.com/spaces/61/index.html",
+      "author": "adegeo",
+      "ms.author": "adegeo"
     },
     "fileMetadata": {
       "titleSuffix": {
@@ -56,6 +144,16 @@
     },
     "template": [],
     "dest": "dotnet-desktop-guide",
-    "markdownEngineName": "markdig"
+    "markdownEngineName": "markdig",
+    "groups": {
+      "framework": {
+        "dest": "framework-dest",
+        "moniker_range": "netframeworkdesktop-4.8"
+      },
+      "net": {
+        "dest": "net-dest",
+        "moniker_range": "netdesktop-5.0"
+      }
+    }
   }
 }

dotnet-desktop-guide/framework/breadcrumb/toc.yml

@@ -0,0 +1,25 @@
+items:
+- name: Docs
+  tocHref: /
+  topicHref: /
+  items:
+    - name: .NET
+      tocHref: /dotnet/
+      topicHref: /dotnet/index
+      items:
+      - name: Desktop Guide
+        tocHref: /dotnet/desktop
+        topicHref: /dotnet/desktop/index
+        items:
+        - name: .NET Framework
+          items:
+          - name: Windows Forms
+            tocHref: /dotnet/desktop/winforms
+            topicHref: /dotnet/desktop/winforms/index
+            items:
+            - name: Enhance Windows Forms applications
+              tocHref: /dotnet/desktop/winforms/advanced/
+              topicHref: /dotnet/desktop/winforms/advanced/index
+            - name: Controls
+              tocHref: /dotnet/desktop/winforms/controls/
+              topicHref: /dotnet/desktop/winforms/controls/index